1..
2    **************************************************
3    *                                                *
4    *   Automatically generated file, do not edit!   *
5    *                                                *
6    **************************************************
7
8.. _amdgpu_synid9_msg:
9
10msg
11===========================
12
13A 16-bit message code. The bits of this operand have the following meaning:
14
15    ============ ======================================================
16    Bits         Description
17    ============ ======================================================
18    3:0          Message *type*.
19    6:4          Optional *operation*.
20    9:7          Optional *parameters*.
21    15:10        Unused.
22    ============ ======================================================
23
24This operand may be specified as a positive 16-bit :ref:`integer_number<amdgpu_synid_integer_number>` or using the syntax described below:
25
26    ======================================== ========================================================================
27    Syntax                                   Description
28    ======================================== ========================================================================
29    sendmsg(<*type*>)                        A message identified by its *type*.
30    sendmsg(<*type*>, <*op*>)                A message identified by its *type* and *operation*.
31    sendmsg(<*type*>, <*op*>, <*stream*>)    A message identified by its *type* and *operation* with a stream *id*.
32    ======================================== ========================================================================
33
34*Type* may be specified using message *name* or message *id*.
35
36*Op* may be specified using operation *name* or operation *id*.
37
38Stream *id* is an integer in the range 0..3.
39
40Message *id*, operation *id* and stream *id* must be specified as positive :ref:`integer numbers<amdgpu_synid_integer_number>`.
41
42Each message type supports specific operations:
43
44    ================= ========== ============================== ============ ==========
45    Message name      Message Id Supported Operations           Operation Id Stream Id
46    ================= ========== ============================== ============ ==========
47    MSG_INTERRUPT     1          \-                             \-           \-
48    MSG_GS            2          GS_OP_CUT                      1            Optional
49    \                            GS_OP_EMIT                     2            Optional
50    \                            GS_OP_EMIT_CUT                 3            Optional
51    MSG_GS_DONE       3          GS_OP_NOP                      0            \-
52    \                            GS_OP_CUT                      1            Optional
53    \                            GS_OP_EMIT                     2            Optional
54    \                            GS_OP_EMIT_CUT                 3            Optional
55    MSG_SYSMSG        15         SYSMSG_OP_ECC_ERR_INTERRUPT    1            \-
56    \                            SYSMSG_OP_REG_RD               2            \-
57    \                            SYSMSG_OP_HOST_TRAP_ACK        3            \-
58    \                            SYSMSG_OP_TTRACE_PC            4            \-
59    ================= ========== ============================== ============ ==========
60
61Examples:
62
63.. parsed-literal::
64
65    s_sendmsg 0x12
66    s_sendmsg sendmsg(MSG_INTERRUPT)
67    s_sendmsg sendmsg(2, GS_OP_CUT)
68    s_sendmsg sendmsg(MSG_GS, GS_OP_EMIT)
69    s_sendmsg sendmsg(MSG_GS, 2)
70    s_sendmsg sendmsg(MSG_GS_DONE, GS_OP_EMIT_CUT, 1)
71    s_sendmsg sendmsg(MSG_SYSMSG, SYSMSG_OP_TTRACE_PC)
72
73