File: RAW_SEND.md

package info (click to toggle)
intel-graphics-compiler2 2.16.0-2
  • links: PTS, VCS
  • area: main
  • in suites: sid
  • size: 106,644 kB
  • sloc: cpp: 805,640; lisp: 287,672; ansic: 16,414; python: 3,952; yacc: 2,588; lex: 1,666; pascal: 313; sh: 186; makefile: 35
file content (120 lines) | stat: -rw-r--r-- 2,635 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
<!---======================= begin_copyright_notice ============================

Copyright (C) 2020-2022 Intel Corporation

SPDX-License-Identifier: MIT

============================= end_copyright_notice ==========================-->

## Opcode

  RAW_SEND = 0x5d

## Format

| | | | | | | |
| --- | --- | --- | --- | --- | --- | --- |
| 0x5d(RAW_SEND) | Modifiers | Exec_size | Pred | ExMsgDesc | NumSrc | NumDst |
|                | Desc      | Src       | Dst  |           |        |        |


## Semantics


```

      A direct method for generating a GEN native send message
```

## Description





    A raw message send that will be translated into a GEN send instruction


- **Modifiers(ub):**

  - Bit[0]: Determines whether send or sendc should be used

    - 0b0:  raw_send
    - 0b1:  raw_sendc

- **Exec_size(ub):** Execution size

  - Bit[2..0]: size of the region for source and destination operands

    - 0b000:  1 element (scalar)
    - 0b001:  2 elements
    - 0b010:  4 elements
    - 0b011:  8 elements
    - 0b100:  16 elements
    - 0b101:  32 elements
  - Bit[7..4]: execution mask (explicit control over the enabled channels)

    - 0b0000:  M1
    - 0b0001:  M2
    - 0b0010:  M3
    - 0b0011:  M4
    - 0b0100:  M5
    - 0b0101:  M6
    - 0b0110:  M7
    - 0b0111:  M8
    - 0b1000:  M1_NM
    - 0b1001:  M2_NM
    - 0b1010:  M3_NM
    - 0b1011:  M4_NM
    - 0b1100:  M5_NM
    - 0b1101:  M6_NM
    - 0b1110:  M7_NM
    - 0b1111:  M8_NM

- **Pred(uw):** Predication control


- **ExMsgDesc(ud):** Extended message descriptor for the send


- **NumSrc(ub):** Number of GRF registers for the send message payload. Valid values are  [1-15]


- **NumDst(ub):** Number of GRF registers for the send message response. Valid values are  [0-16]


- **Desc(scalar):** Message descriptor for the send. Must have type UD


- **Src(raw_operand):** The raw operand of a general variable storing the send message payload


- **Dst(raw_operand):** The raw operand of a general variable storing send message response


#### Properties




## Text
```



    [(<P>)] {raw_send|raw_sendc} (<exec_size>) <ExMsgDesc> <NumSrc> <NumDst> <Desc> <Src> <Dst>
```
## Notes





    This instruction is intended for expert users who want to access a fixed
    function that is currently not available in vISA. As such, it is the
    user's responsibility to ensure that the message descriptor, shared
    function id, together with the message source and destination form a
    correct send instruction for the given GEN platform. The JIT-compiler
    simply translates it into a GEN send instruction without any error
    check.