[AMDGPU][GFX7][DOC][NFC] Update assembler syntax description

Summary of changes:
- Updated MUBUF lds syntax (see https://reviews.llvm.org/D124485).
- Enabled literals with src0 of v_madak_f32, v_madmk_f32 (see https://reviews.llvm.org/D111067).
- Corrected LGKM_CNT description.
- Minor bug fixing.
This commit is contained in:
Dmitry Preobrazhensky
2022-06-06 15:50:10 +03:00
parent cc30d43ce4
commit 9c7e803f2d
83 changed files with 1373 additions and 1379 deletions

File diff suppressed because it is too large Load Diff

View File

@@ -41,17 +41,17 @@ or :ref:`absolute expressions<amdgpu_synid_absolute_expression>`.
Defined register *names* include:
=================== ==========================================
Name Description
=================== ==========================================
HW_REG_MODE Shader writeable mode bits.
HW_REG_STATUS Shader read-only status.
HW_REG_TRAPSTS Trap status.
HW_REG_HW_ID Id of wave, simd, compute unit, etc.
HW_REG_GPR_ALLOC Per-wave SGPR and VGPR allocation.
HW_REG_LDS_ALLOC Per-wave LDS allocation.
HW_REG_IB_STS Counters of outstanding instructions.
=================== ==========================================
============================== ==========================================
Name Description
============================== ==========================================
HW_REG_MODE Shader writeable mode bits.
HW_REG_STATUS Shader read-only status.
HW_REG_TRAPSTS Trap status.
HW_REG_HW_ID Id of wave, simd, compute unit, etc.
HW_REG_GPR_ALLOC Per-wave SGPR and VGPR allocation.
HW_REG_LDS_ALLOC Per-wave LDS allocation.
HW_REG_IB_STS Counters of outstanding instructions.
============================== ==========================================
Examples:

View File

@@ -1,13 +0,0 @@
..
**************************************************
* *
* Automatically generated file, do not edit! *
* *
**************************************************
.. _amdgpu_synid_gfx7_imm16_2:
imm16
=====
A 16-bit :ref:`integer_number<amdgpu_synid_integer_number>` or an :ref:`absolute_expression<amdgpu_synid_absolute_expression>`. The value must be in the range -32768..65535.

View File

@@ -5,7 +5,7 @@
* *
**************************************************
.. _amdgpu_synid_gfx7_imm16:
.. _amdgpu_synid_gfx7_imm16_73139a:
imm16
=====

View File

@@ -5,7 +5,7 @@
* *
**************************************************
.. _amdgpu_synid_gfx7_imm16_1:
.. _amdgpu_synid_gfx7_imm16_a04fb3:
imm16
=====

View File

@@ -47,22 +47,22 @@ or :ref:`absolute expressions<amdgpu_synid_absolute_expression>`.
Each message type supports specific operations:
================= ========== ============================== ============ ==========
Message name Message Id Supported Operations Operation Id Stream Id
================= ========== ============================== ============ ==========
MSG_INTERRUPT 1 \- \- \-
MSG_GS 2 GS_OP_CUT 1 Optional
\ GS_OP_EMIT 2 Optional
\ GS_OP_EMIT_CUT 3 Optional
MSG_GS_DONE 3 GS_OP_NOP 0 \-
\ GS_OP_CUT 1 Optional
\ GS_OP_EMIT 2 Optional
\ GS_OP_EMIT_CUT 3 Optional
MSG_SYSMSG 15 SYSMSG_OP_ECC_ERR_INTERRUPT 1 \-
\ SYSMSG_OP_REG_RD 2 \-
\ SYSMSG_OP_HOST_TRAP_ACK 3 \-
\ SYSMSG_OP_TTRACE_PC 4 \-
================= ========== ============================== ============ ==========
====================== ========== ============================== ============ ==========
Message name Message Id Supported Operations Operation Id Stream Id
====================== ========== ============================== ============ ==========
MSG_INTERRUPT 1 \- \- \-
MSG_GS 2 GS_OP_CUT 1 Optional
\ GS_OP_EMIT 2 Optional
\ GS_OP_EMIT_CUT 3 Optional
MSG_GS_DONE 3 GS_OP_NOP 0 \-
\ GS_OP_CUT 1 Optional
\ GS_OP_EMIT 2 Optional
\ GS_OP_EMIT_CUT 3 Optional
MSG_SYSMSG 15 SYSMSG_OP_ECC_ERR_INTERRUPT 1 \-
\ SYSMSG_OP_REG_RD 2 \-
\ SYSMSG_OP_HOST_TRAP_ACK 3 \-
\ SYSMSG_OP_TTRACE_PC 4 \-
====================== ========== ============================== ============ ==========
*Sendmsg* arguments are validated depending on how *type* value is specified:

View File

@@ -0,0 +1,13 @@
..
**************************************************
* *
* Automatically generated file, do not edit! *
* *
**************************************************
.. _amdgpu_synid_gfx7_opt_0d447d:
opt
===
This is an optional operand. It must be used if and only if :ref:`lds<amdgpu_synid_lds>` is omitted.

View File

@@ -5,7 +5,7 @@
* *
**************************************************
.. _amdgpu_synid_gfx7_opt:
.. _amdgpu_synid_gfx7_opt_847aed:
opt
===

View File

@@ -5,7 +5,7 @@
* *
**************************************************
.. _amdgpu_synid_gfx7_sbase:
.. _amdgpu_synid_gfx7_sbase_010ce0:
sbase
=====

View File

@@ -5,7 +5,7 @@
* *
**************************************************
.. _amdgpu_synid_gfx7_sbase_1:
.. _amdgpu_synid_gfx7_sbase_382fdf:
sbase
=====

View File

@@ -5,7 +5,7 @@
* *
**************************************************
.. _amdgpu_synid_gfx7_sdst_3:
.. _amdgpu_synid_gfx7_sdst_0804b1:
sdst
====

View File

@@ -5,7 +5,7 @@
* *
**************************************************
.. _amdgpu_synid_gfx7_sdst:
.. _amdgpu_synid_gfx7_sdst_2a1d2e:
sdst
====

View File

@@ -5,7 +5,7 @@
* *
**************************************************
.. _amdgpu_synid_gfx7_sdst_1:
.. _amdgpu_synid_gfx7_sdst_313759:
sdst
====

View File

@@ -5,7 +5,7 @@
* *
**************************************************
.. _amdgpu_synid_gfx7_sdst_4:
.. _amdgpu_synid_gfx7_sdst_362c37:
sdst
====

View File

@@ -5,7 +5,7 @@
* *
**************************************************
.. _amdgpu_synid_gfx7_sdst_7:
.. _amdgpu_synid_gfx7_sdst_61ce79:
sdst
====

View File

@@ -5,7 +5,7 @@
* *
**************************************************
.. _amdgpu_synid_gfx7_sdst_5:
.. _amdgpu_synid_gfx7_sdst_6cc8e9:
sdst
====

View File

@@ -5,7 +5,7 @@
* *
**************************************************
.. _amdgpu_synid_gfx7_sdst_2:
.. _amdgpu_synid_gfx7_sdst_9172f3:
sdst
====

View File

@@ -5,7 +5,7 @@
* *
**************************************************
.. _amdgpu_synid_gfx7_sdst_6:
.. _amdgpu_synid_gfx7_sdst_e3bd3f:
sdst
====

View File

@@ -5,10 +5,10 @@
* *
**************************************************
.. _amdgpu_synid_gfx7_simm32_1:
.. _amdgpu_synid_gfx7_simm32_6f0844:
simm32
======
A :ref:`floating-point_number<amdgpu_synid_floating-point_number>`, an :ref:`integer_number<amdgpu_synid_integer_number>`, or an :ref:`absolute_expression<amdgpu_synid_absolute_expression>`.
The value is converted to *f32* as described :ref:`here<amdgpu_synid_fp_conv>`.
The value is converted to *f32* as described :ref:`here<amdgpu_synid_conv>`.

View File

@@ -5,7 +5,7 @@
* *
**************************************************
.. _amdgpu_synid_gfx7_simm32:
.. _amdgpu_synid_gfx7_simm32_a3e80c:
simm32
======

View File

@@ -5,7 +5,7 @@
* *
**************************************************
.. _amdgpu_synid_gfx7_soffset_1:
.. _amdgpu_synid_gfx7_soffset_1bad09:
soffset
=======

View File

@@ -5,7 +5,7 @@
* *
**************************************************
.. _amdgpu_synid_gfx7_soffset:
.. _amdgpu_synid_gfx7_soffset_48c95e:
soffset
=======

View File

@@ -5,7 +5,7 @@
* *
**************************************************
.. _amdgpu_synid_gfx7_src_2:
.. _amdgpu_synid_gfx7_src_1f730e:
src
===

View File

@@ -5,7 +5,7 @@
* *
**************************************************
.. _amdgpu_synid_gfx7_src_7:
.. _amdgpu_synid_gfx7_src_3865f6:
src
===

View File

@@ -5,7 +5,7 @@
* *
**************************************************
.. _amdgpu_synid_gfx7_src_9:
.. _amdgpu_synid_gfx7_src_3e3a6b:
src
===

View File

@@ -5,7 +5,7 @@
* *
**************************************************
.. _amdgpu_synid_gfx7_src_3:
.. _amdgpu_synid_gfx7_src_516946:
src
===

View File

@@ -5,7 +5,7 @@
* *
**************************************************
.. _amdgpu_synid_gfx7_src_4:
.. _amdgpu_synid_gfx7_src_5599b0:
src
===

View File

@@ -5,7 +5,7 @@
* *
**************************************************
.. _amdgpu_synid_gfx7_src_10:
.. _amdgpu_synid_gfx7_src_5c4f8d:
src
===

View File

@@ -5,7 +5,7 @@
* *
**************************************************
.. _amdgpu_synid_gfx7_src_6:
.. _amdgpu_synid_gfx7_src_8e54a0:
src
===

View File

@@ -5,7 +5,7 @@
* *
**************************************************
.. _amdgpu_synid_gfx7_src_8:
.. _amdgpu_synid_gfx7_src_935f3b:
src
===

View File

@@ -5,7 +5,7 @@
* *
**************************************************
.. _amdgpu_synid_gfx7_src_1:
.. _amdgpu_synid_gfx7_src_d48e27:
src
===

View File

@@ -5,7 +5,7 @@
* *
**************************************************
.. _amdgpu_synid_gfx7_src_5:
.. _amdgpu_synid_gfx7_src_d56c56:
src
===

View File

@@ -5,7 +5,7 @@
* *
**************************************************
.. _amdgpu_synid_gfx7_src:
.. _amdgpu_synid_gfx7_src_fa88a6:
src
===

View File

@@ -5,7 +5,7 @@
* *
**************************************************
.. _amdgpu_synid_gfx7_srsrc:
.. _amdgpu_synid_gfx7_srsrc_cf7132:
srsrc
=====

View File

@@ -5,7 +5,7 @@
* *
**************************************************
.. _amdgpu_synid_gfx7_srsrc_1:
.. _amdgpu_synid_gfx7_srsrc_e73d16:
srsrc
=====

View File

@@ -5,7 +5,7 @@
* *
**************************************************
.. _amdgpu_synid_gfx7_ssrc:
.. _amdgpu_synid_gfx7_ssrc_19a078:
ssrc
====

View File

@@ -5,7 +5,7 @@
* *
**************************************************
.. _amdgpu_synid_gfx7_ssrc_5:
.. _amdgpu_synid_gfx7_ssrc_2e8313:
ssrc
====

View File

@@ -5,7 +5,7 @@
* *
**************************************************
.. _amdgpu_synid_gfx7_ssrc_1:
.. _amdgpu_synid_gfx7_ssrc_6df989:
ssrc
====

View File

@@ -5,7 +5,7 @@
* *
**************************************************
.. _amdgpu_synid_gfx7_ssrc_8:
.. _amdgpu_synid_gfx7_ssrc_a778e3:
ssrc
====

View File

@@ -5,7 +5,7 @@
* *
**************************************************
.. _amdgpu_synid_gfx7_ssrc_6:
.. _amdgpu_synid_gfx7_ssrc_b0d552:
ssrc
====

View File

@@ -5,7 +5,7 @@
* *
**************************************************
.. _amdgpu_synid_gfx7_ssrc_4:
.. _amdgpu_synid_gfx7_ssrc_bdc010:
ssrc
====

View File

@@ -5,7 +5,7 @@
* *
**************************************************
.. _amdgpu_synid_gfx7_ssrc_7:
.. _amdgpu_synid_gfx7_ssrc_c5f5de:
ssrc
====

View File

@@ -5,7 +5,7 @@
* *
**************************************************
.. _amdgpu_synid_gfx7_ssrc_10:
.. _amdgpu_synid_gfx7_ssrc_d8712d:
ssrc
====

View File

@@ -5,7 +5,7 @@
* *
**************************************************
.. _amdgpu_synid_gfx7_ssrc_9:
.. _amdgpu_synid_gfx7_ssrc_dcdeb4:
ssrc
====

View File

@@ -5,7 +5,7 @@
* *
**************************************************
.. _amdgpu_synid_gfx7_ssrc_3:
.. _amdgpu_synid_gfx7_ssrc_e471f7:
ssrc
====

View File

@@ -5,7 +5,7 @@
* *
**************************************************
.. _amdgpu_synid_gfx7_ssrc_2:
.. _amdgpu_synid_gfx7_ssrc_fdbed3:
ssrc
====

View File

@@ -12,12 +12,12 @@ tgt
An export target:
============== ===================================
Syntax Description
============== ===================================
pos{0..3} Copy vertex position 0..3.
param{0..31} Copy vertex parameter 0..31.
mrt{0..7} Copy pixel color to the MRTs 0..7.
mrtz Copy pixel depth (Z) data.
null Copy nothing.
============== ===================================
================== ===================================
Syntax Description
================== ===================================
pos{0..3} Copy vertex position 0..3.
param{0..31} Copy vertex parameter 0..31.
mrt{0..7} Copy pixel color to the MRTs 0..7.
mrtz Copy pixel depth (Z) data.
null Copy nothing.
================== ===================================

View File

@@ -5,7 +5,7 @@
* *
**************************************************
.. _amdgpu_synid_gfx7_vaddr_1:
.. _amdgpu_synid_gfx7_vaddr_9f7133:
vaddr
=====

View File

@@ -5,7 +5,7 @@
* *
**************************************************
.. _amdgpu_synid_gfx7_vaddr_3:
.. _amdgpu_synid_gfx7_vaddr_da1f09:
vaddr
=====

View File

@@ -5,7 +5,7 @@
* *
**************************************************
.. _amdgpu_synid_gfx7_vaddr_2:
.. _amdgpu_synid_gfx7_vaddr_e9b690:
vaddr
=====

View File

@@ -5,7 +5,7 @@
* *
**************************************************
.. _amdgpu_synid_gfx7_vaddr:
.. _amdgpu_synid_gfx7_vaddr_f20ee4:
vaddr
=====

View File

@@ -5,7 +5,7 @@
* *
**************************************************
.. _amdgpu_synid_gfx7_vdata0:
.. _amdgpu_synid_gfx7_vdata0_6802ce:
vdata0
======

View File

@@ -5,7 +5,7 @@
* *
**************************************************
.. _amdgpu_synid_gfx7_vdata0_1:
.. _amdgpu_synid_gfx7_vdata0_fd235e:
vdata0
======

View File

@@ -5,7 +5,7 @@
* *
**************************************************
.. _amdgpu_synid_gfx7_vdata1:
.. _amdgpu_synid_gfx7_vdata1_6802ce:
vdata1
======

View File

@@ -5,7 +5,7 @@
* *
**************************************************
.. _amdgpu_synid_gfx7_vdata1_1:
.. _amdgpu_synid_gfx7_vdata1_fd235e:
vdata1
======

View File

@@ -5,7 +5,7 @@
* *
**************************************************
.. _amdgpu_synid_gfx7_vdata_4:
.. _amdgpu_synid_gfx7_vdata_325b78:
vdata
=====

View File

@@ -5,7 +5,7 @@
* *
**************************************************
.. _amdgpu_synid_gfx7_vdata_5:
.. _amdgpu_synid_gfx7_vdata_4d8ecf:
vdata
=====

View File

@@ -5,7 +5,7 @@
* *
**************************************************
.. _amdgpu_synid_gfx7_vdata_3:
.. _amdgpu_synid_gfx7_vdata_56f215:
vdata
=====

View File

@@ -5,7 +5,7 @@
* *
**************************************************
.. _amdgpu_synid_gfx7_vdata:
.. _amdgpu_synid_gfx7_vdata_6802ce:
vdata
=====

View File

@@ -5,7 +5,7 @@
* *
**************************************************
.. _amdgpu_synid_gfx7_vdata_9:
.. _amdgpu_synid_gfx7_vdata_87fb90:
vdata
=====

View File

@@ -5,7 +5,7 @@
* *
**************************************************
.. _amdgpu_synid_gfx7_vdata_8:
.. _amdgpu_synid_gfx7_vdata_b2a787:
vdata
=====

View File

@@ -5,7 +5,7 @@
* *
**************************************************
.. _amdgpu_synid_gfx7_vdata_6:
.. _amdgpu_synid_gfx7_vdata_c08393:
vdata
=====

View File

@@ -5,7 +5,7 @@
* *
**************************************************
.. _amdgpu_synid_gfx7_vdata_7:
.. _amdgpu_synid_gfx7_vdata_c61803:
vdata
=====

View File

@@ -5,7 +5,7 @@
* *
**************************************************
.. _amdgpu_synid_gfx7_vdata_2:
.. _amdgpu_synid_gfx7_vdata_e016a1:
vdata
=====

View File

@@ -5,7 +5,7 @@
* *
**************************************************
.. _amdgpu_synid_gfx7_vdata_1:
.. _amdgpu_synid_gfx7_vdata_fd235e:
vdata
=====

View File

@@ -5,7 +5,7 @@
* *
**************************************************
.. _amdgpu_synid_gfx7_vdst_6:
.. _amdgpu_synid_gfx7_vdst_0c25a6:
vdst
====

View File

@@ -5,7 +5,7 @@
* *
**************************************************
.. _amdgpu_synid_gfx7_vdst_7:
.. _amdgpu_synid_gfx7_vdst_3d7dcf:
vdst
====

View File

@@ -5,7 +5,7 @@
* *
**************************************************
.. _amdgpu_synid_gfx7_vdst_5:
.. _amdgpu_synid_gfx7_vdst_463513:
vdst
====

View File

@@ -5,7 +5,7 @@
* *
**************************************************
.. _amdgpu_synid_gfx7_vdst_3:
.. _amdgpu_synid_gfx7_vdst_48e42f:
vdst
====

View File

@@ -5,7 +5,7 @@
* *
**************************************************
.. _amdgpu_synid_gfx7_vdst_8:
.. _amdgpu_synid_gfx7_vdst_5d50a1:
vdst
====

View File

@@ -5,7 +5,7 @@
* *
**************************************************
.. _amdgpu_synid_gfx7_vdst_2:
.. _amdgpu_synid_gfx7_vdst_69a144:
vdst
====

View File

@@ -5,14 +5,14 @@
* *
**************************************************
.. _amdgpu_synid_gfx7_vdst_12:
.. _amdgpu_synid_gfx7_vdst_875645:
vdst
====
Instruction output: data read from a memory buffer.
If :ref:`lds<amdgpu_synid_lds>` is specified, this operand is ignored by H/W and data are stored directly into LDS.
This is an optional operand. It must be used if and only if :ref:`lds<amdgpu_synid_lds>` is omitted.
*Size:* 1 dword by default. :ref:`tfe<amdgpu_synid_tfe>` adds 1 dword if specified.

View File

@@ -5,7 +5,7 @@
* *
**************************************************
.. _amdgpu_synid_gfx7_vdst:
.. _amdgpu_synid_gfx7_vdst_89680f:
vdst
====

View File

@@ -5,7 +5,7 @@
* *
**************************************************
.. _amdgpu_synid_gfx7_vdst_10:
.. _amdgpu_synid_gfx7_vdst_a49b76:
vdst
====

View File

@@ -5,7 +5,7 @@
* *
**************************************************
.. _amdgpu_synid_gfx7_vdst_1:
.. _amdgpu_synid_gfx7_vdst_bdb32f:
vdst
====

View File

@@ -5,7 +5,7 @@
* *
**************************************************
.. _amdgpu_synid_gfx7_vdst_4:
.. _amdgpu_synid_gfx7_vdst_d0dc43:
vdst
====

View File

@@ -5,7 +5,7 @@
* *
**************************************************
.. _amdgpu_synid_gfx7_vdst_9:
.. _amdgpu_synid_gfx7_vdst_d7c57e:
vdst
====

View File

@@ -5,7 +5,7 @@
* *
**************************************************
.. _amdgpu_synid_gfx7_vdst_11:
.. _amdgpu_synid_gfx7_vdst_f47754:
vdst
====

View File

@@ -5,7 +5,7 @@
* *
**************************************************
.. _amdgpu_synid_gfx7_vsrc:
.. _amdgpu_synid_gfx7_vsrc_533a4e:
vsrc
====

View File

@@ -5,7 +5,7 @@
* *
**************************************************
.. _amdgpu_synid_gfx7_vsrc_1:
.. _amdgpu_synid_gfx7_vsrc_6802ce:
vsrc
====

View File

@@ -5,7 +5,7 @@
* *
**************************************************
.. _amdgpu_synid_gfx7_vsrc_2:
.. _amdgpu_synid_gfx7_vsrc_e016a1:
vsrc
====

View File

@@ -5,7 +5,7 @@
* *
**************************************************
.. _amdgpu_synid_gfx7_vsrc_3:
.. _amdgpu_synid_gfx7_vsrc_fd235e:
vsrc
====

View File

@@ -19,7 +19,7 @@ The bits of this operand have the following meaning:
===== ================================================ ============
3:0 VM_CNT: vector memory operations count. 0..15
6:4 EXP_CNT: export count. 0..7
12:8 LGKM_CNT: LDS, GDS, Constant and Message count. 0..31
11:8 LGKM_CNT: LDS, GDS, Constant and Message count. 0..15
===== ================================================ ============
This operand may be specified as one of the following: