(no commit message)
[libreriscv.git] / openpower / sv / svp_rewrite / svp64.mdwn
1 # Rewrite of SVP64 for OpenPower ISA v3.1
2
3 * [[svp64/discussion]]
4
5 The plan is to create an encoding for SVP64, then to create an encoding for
6 SVP48, then to reorganize them both to improve field overlap, reducing the
7 amount of decoder hardware necessary.
8
9 All bit numbers are in MSB0 form (the bits are numbered from 0 at the MSB and
10 counting up as you move to the LSB end). All bit ranges are inclusive (so
11 `4:6` means bits 4, 5, and 6).
12
13 64-bit instructions are split into two 32-bit words, the prefix and the suffix. The prefix always comes before the suffix in PC order.
14
15 SVP64 is designed so that when the prefix is all zeros, no effect or influence occurs (no augmentation) such that all standard OpenPOWER v3.B instructions may be active at that time, in full (and SV is quiescent). The corollary is that when the SV prefix is nonzero, alternative meanings may be given to all and any instructions.
16
17 # Definition of Reserved in this spec.
18
19 For the new fields added in SVP64, instructions that have any of their fields set to a reserved value must cause an illegal instruction trap, to allow emulation of future instruction sets.
20
21 This is unlike OpenPower ISA v3.1, which doesn't require a CPU to trap.
22
23 # Remapped Encoding (`RM[0:23]`)
24
25 To allow relatively easy remapping of which portions of the Prefix Opcode Map
26 are used for SVP64 without needing to rewrite a large portion of the SVP64
27 spec, a mapping is defined from the OpenPower v3.1 prefix bits to a new 24-bit
28 Remapped Encoding denoted `RM[0]` at the MSB to `RM[23]` at the LSB.
29
30 The mapping from the OpenPower v3.1 prefix bits to the Remapped Encoding is
31 defined in the Prefix Fields section.
32 ## Prefix Opcode Map (64-bit instruction encoding) (prefix bits 6:11)
33
34 (shows both PowerISA v3.1 instructions as well as new SVP instructions; empty spaces are yet-to-be-allocated Illegal Instructions)
35
36 | bits 6:11 | ---000 | ---001 | ---010 | ---011 | ---100 | ---101 | ---110 | ---111 |
37 |-----------|----------|------------|----------|----------|----------|----------|----------|----------|
38 | 000--- | 8LS-form | 8LS-form | 8LS-form | 8LS-form | 8LS-form | 8LS-form | 8LS-form | 8LS-form |
39 | 001--- | | | | | | | | |
40 | 010--- | 8RR-form | | | | SVP64 | SVP64 | SVP64 | SVP64 |
41 | 011--- | | | | | SVP64 | SVP64 | SVP64 | SVP64 |
42 | 100--- | MLS-form | MLS-form | MLS-form | MLS-form | MLS-form | MLS-form | MLS-form | MLS-form |
43 | 101--- | | | | | | | | |
44 | 110--- | MRR-form | | | | SVP64 | SVP64 | SVP64 | SVP64 |
45 | 111--- | | MMIRR-form | | | SVP64 | SVP64 | SVP64 | SVP64 |
46
47 ## Prefix Fields
48
49 | Prefix Field Name | Field bits | Constant Value | Description |
50 |---------------------|------------|----------------|--------------------------------------------|
51 | PO (Primary Opcode) | `0:5` | `1` | Indicates this is a 64-bit instruction |
52 | `RM[0]` | `6` | | Bit 0 of the Remapped Encoding |
53 | SVP64_7 | `7` | `1` | Indicates this is a SVP64 instruction |
54 | `RM[1]` | `8` | | Bit 1 of the Remapped Encoding |
55 | SVP64_9 | `9` | `1` | Indicates this is a SVP64 instruction |
56 | `RM[2:23]` | `10:31` | | Bits 2 through 23 of the Remapped Encoding |
57
58
59 # Remapped Encoding Fields
60
61 Shows all fields in the Remapped Encoding `RM[0:23]` for all instruction variants. There are two categories: Single and Twin Predication. Due to space considerations further subdivision of Single Predication is based on whether the number of src operands is 2 or 3.
62
63 ## Single Predication dest/src1/2/3
64
65 applies to 4-operand instructions (fmadd, isel, madd).
66
67 | Field Name | Field bits | Description |
68 |------------|------------|------------------------------------------------|
69 | MASK_KIND | `0` | Execution Mask Kind |
70 | MASK | `1:3` | Execution Mask |
71 | ELWIDTH | `4:5` | Element Width |
72 | SUBVL | `6:7` | Sub-vector length |
73 | Rdest_EXTRA2 | `8:9` | extra bits for Rdest (R\*_EXTRA2 Encoding) |
74 | Rsrc1_EXTRA2 | `10:11` | extra bits for Rsrc1 (R\*_EXTRA2 Encoding) |
75 | Rsrc2_EXTRA2 | `12:13` | extra bits for Rsrc2 (R\*_EXTRA2 Encoding) |
76 | Rsrc3_EXTRA2 | `14:15` | extra bits for Rsrc3 (R\*_EXTRA2 Encoding|
77 | reserved | `16` | reserved |
78 | MODE | `19:23` | see [[discussion]] |
79
80
81 ## Single Predication dest/src1/2
82
83 applies to 3-operand instructions (src1 src2 dest)
84
85 | Field Name | Field bits | Description |
86 |------------|------------|------------------------------------------------|
87 | MASK_KIND | `0` | Execution Mask Kind |
88 | MASK | `1:3` | Execution Mask |
89 | ELWIDTH | `4:5` | Element Width |
90 | SUBVL | `6:7` | Sub-vector length |
91 | Rdest_EXTRA3 | `8:10` | extra bits for Rdest (Uses R\*_EXTRA3 Encoding) |
92 | Rsrc1_EXTRA3 | `11:13` | extra bits for Rsrc1 (Uses R\*_EXTRA3 Encoding) |
93 | Rsrc2_EXTRA3 | `14:16` | extra bits for Rsrc3 (Uses R\*_EXTRA3 Encoding) |
94 | MODE | `19:23` | see [[discussion]] |
95
96 ## Twin Predication (src=1, dest=1)
97
98 | Field Name | Field bits | Description |
99 |------------|------------|----------------------------|
100 | MASK_KIND | `0` | Execution Mask Kind |
101 | MASK | `1:3` | Execution Mask |
102 | ELWIDTH | `4:5` | Element Width |
103 | SUBVL | `6:7` | Sub-vector length |
104 | Rdest_EXTRA3 | `8:10` | extra bits for Rdest |
105 | Rsrc1_EXTRA3 | `11:13` | extra bits for Rsrc1 |
106 | MASK_SRC | `14:16` | Execution Mask for Source |
107 | ELWIDTH_SRC | `17:18` | Element Width for Source |
108 | MODE | `19:23` | see [[discussion]] |
109
110 note in [[discussion]]: TODO, evaluate if 2nd SUBVL should be added. conclusion: no. 2nd SUBVL makes no sense except for mv, and that is covered by [[mv.vec]]
111
112 ## R\*_EXTRA2 and R\*_EXTRA3 Encoding
113
114 (**TODO: 2-bit version of the table, just like in the original SVPrefix. This is important, to save bits on 4-operand instructions such as fmadd**)
115
116 In the following table, `<N>` denotes the value of the corresponding register field in the SVP64 suffix word.
117
118 (**Jacob: these tables are not in the slightest bit understandable due to the use of register names that are impossible to interpret clearly**)
119
120 3 bit version
121
122 | R\*_EXTRA3 | Vector/Scalar<br/>Mode | CR Register | Int/FP<br/>Register |
123 |-----------|------------------------|---------------|---------------------|
124 | 000 | Scalar | `SVCR<N>_000` | `SV[F]R<N>_00` |
125 | 001 | Scalar | `SVCR<N>_010` | `SV[F]R<N>_01` |
126 | 010 | Scalar | `SVCR<N>_100` | `SV[F]R<N>_10` |
127 | 011 | Scalar | `SVCR<N>_110` | `SV[F]R<N>_11` |
128 | 100 | Vector | `SVCR<N>_000` | `SV[F]R<N>_00` |
129 | 101 | Vector | `SVCR<N>_010` | `SV[F]R<N>_01` |
130 | 110 | Vector | `SVCR<N>_100` | `SV[F]R<N>_10` |
131 | 111 | Vector | `SVCR<N>_110` | `SV[F]R<N>_11` |
132
133 alternative which is understandable and, if EXTRA3 is zero, maps to "no effect" (scalar OpenPOWER ISA field naming)
134
135 | R\*_EXTRA3 | Mode | CR Register | Int/FP<br/>Register |
136 |-----------|-------|---------------|---------------------|
137 | 000 | Scalar | `` | `0b00 RA` |
138 | 001 | Scalar | `` | `0b01 RA` |
139 | 010 | Scalar | `` | `0b10 RA` |
140 | 011 | Scalar | `` | `0b11 RA` |
141 | 100 | Vector | `` | `RA 0b00` |
142 | 101 | Vector | `` | `RA 0b01` |
143 | 110 | Vector | `` | `RA 0b10` |
144 | 111 | Vector | `` | `RA 0b11` |
145
146 2 bit version
147
148 (**TODO, i simply cannot interpret the names, they have absolutely zero meaning to me so i have no idea how to fill in the table. this is a bad sign, indicative that the names have to go, to be replaced by something xlear snd obvious**)
149
150 | R\*_EXTRA2 | Mode | CR Register | Int/FP<br/>Register |
151 |-----------|---------|---------------|---------------------|
152 | 00 | Scalar | `SVCR<N>_000` | `SV[F]R<N>_00` |
153 | 01 | Scalar | `SVCR<N>_100` | `SV[F]R<N>_10` |
154 | 10 | Vector | `SVCR<N>_000` | `SV[F]R<N>_00` |
155 | 11 | Vector | `SVCR<N>_100` | `SV[F]R<N>_10` |
156
157 alternative which is understandable and, if EXTRA2 is zero will map to "no effect" i.e Scalar OpenPOWER register naming:
158
159 | R\*_EXTRA2 | Mode | CR Register | Int/FP<br/>Register |
160 |-----------|-------|---------------|---------------------|
161 | 00 | Scalar | `` | `0b00 RA` |
162 | 01 | Scalar | `` | `0b01 RA` |
163 | 10 | Vector | `` | `RA 0b00` |
164 | 11 | Vector | `` | `RA 0b10` |
165
166 ## ELWIDTH Encoding
167
168 Default behaviour is set to 0b00 so that zeros follow the convention of "npt doing anything". In this case it means that elwidth overrides are not applicable. Thus if a 32 bit instruction operates on 32 bit, `elwidth=0b00` specifies that this behaviour is unmodified. Likewise when a processor is switched from 64 bit to 32 bit mode, `elwidth=0b00` states that, again, the behaviour is not to be modified.
169
170 Only when elwidth is nonzero is the element width overridden to the explicitly required value.
171
172 | Op Kind | Value | Mnemonic | Description |
173 |---------|-------|----------------|------------------------------------|
174 | Integer | 00 | DEFAULT | default behaviour for operation |
175 | Integer | 01 | `ELWIDTH=b` | Byte: 8-bit integer |
176 | Integer | 10 | `ELWIDTH=h` | Halfword: 16-bit integer |
177 | Integer | 11 | `ELWIDTH=w` | Word: 32-bit integer |
178 | FP | 00 | DEFAULT | default behaviour for FP operation |
179 | FP | 01 | `ELWIDTH=bf16` (rsvd) | Reserved for [`bf16`](https://en.wikipedia.org/wiki/Bfloat16_floating-point_format) |
180 | FP | 10 | `ELWIDTH=f16` | 16-bit IEEE 754 Half floating-point |
181 | FP | 11 | `ELWIDTH=f32` | 32-bit IEEE 754 Single floating-point |
182
183 ## SUBVL Encoding
184
185 | SUBVL Value | Mnemonic | Description |
186 |-------------|---------------------|------------------------|
187 | 00 | `SUBVL=4` | Sub-vector length of 4 |
188 | 01 | `SUBVL=1` (default) | Sub-vector length of 1 |
189 | 10 | `SUBVL=2` | Sub-vector length of 2 |
190 | 11 | `SUBVL=3` | Sub-vector length of 3 |
191
192 ## MASK/MASK_SRC & MASK_KIND Encoding
193
194 One bit (`MASKMODE`) indicates the mode: CR or Int predication. The two types may not be mixed.
195
196 | MASK_KIND Value | Description |
197 |-----------------|------------------------------------------------------|
198 | 0 | MASK/MASK_SRC are encoded using Integer Predication |
199 | 1 | MASK/MASK_SRC are encoded using CR-based Predication |
200
201 Integer Twin predication has a second set if 3 bits that uses the same encoding thus allowing either the same register (r3 or r10) to be used for both src and dest, or different regs (one for src, one for dest).
202
203 Likewise CR based twin predication has a second set of 3 bits, allowing a different test to be applied.
204
205 ### Integer Predication (MASK_KIND=0)
206
207 When the predicate mode bit is zero the 3 bits are interpreted as below.
208 Twin predication has an identical 3 bit field similarly encoded.
209
210 | MASK/MASK_SRC<br/>Value | Mnemonic | Description |
211 |-------------------------|----------|--------------------------------------------------------|
212 | 000 | ALWAYS | Operation is not masked (mask set to all 1s) |
213 | 001 | 1 << R3 | Element `i` is enabled if `i == R3` |
214 | 010 | R3 | Element `i` is enabled if `R3 & (1 << i)` is non-zero |
215 | 011 | ~R3 | Element `i` is enabled if `R3 & (1 << i)` is zero |
216 | 100 | R10 | Element `i` is enabled if `R10 & (1 << i)` is non-zero |
217 | 101 | ~R10 | Element `i` is enabled if `R10 & (1 << i)` is zero |
218 | 110 | R30 | Element `i` is enabled if `R30 & (1 << i)` is non-zero |
219 | 111 | ~R30 | Element `i` is enabled if `R30 & (1 << i)` is zero |
220
221 ### CR-based Predication (MASK_KIND=1)
222
223 When the predicate mode bit is one the 3 bits are interpreted as below. Twin predication has an identical 3 bit field similarly encoded
224
225 | MASK/MASK_SRC<br/>Value | Mnemonic | Description |
226 |-------------------------|----------|-------------------------------------------------|
227 | 000 | lt | Element `i` is enabled if `CR[6+i].LT` is set |
228 | 001 | nl/ge | Element `i` is enabled if `CR[6+i].LT` is clear |
229 | 010 | gt | Element `i` is enabled if `CR[6+i].GT` is set |
230 | 011 | ng/le | Element `i` is enabled if `CR[6+i].GT` is clear |
231 | 100 | eq | Element `i` is enabled if `CR[6+i].EQ` is set |
232 | 101 | ne | Element `i` is enabled if `CR[6+i].EQ` is clear |
233 | 110 | so/un | Element `i` is enabled if `CR[6+i].FU` is set |
234 | 111 | ns/nu | Element `i` is enabled if `CR[6+i].FU` is clear |
235
236 CR based predication. TODO: select alternate CR for twin predication? see [[discussion]] Overlap of the two CR based predicates must be taken into account, so the starting point for one of them must be suitably high, or accept that for twin predication VL must not exceed the range where overlap will occur, *or* that they use the same starting point but select different *bits* of the same CRs
237
238
239 # Twin Predication
240
241 This is a novel concept that allows predication to be applied to a single source and a single dest register. The following types of traditional Vector operations may be encoded with it, *without requiring explicit opcodes to do so*
242
243 * VSPLAT (a single scalar distributed across a vector)
244 * VEXTRACT (like LLVM IR [`extractelement`](https://releases.llvm.org/11.0.0/docs/LangRef.html#extractelement-instruction))
245 * VINSERT (like LLVM IR [`insertelement`](https://releases.llvm.org/11.0.0/docs/LangRef.html#insertelement-instruction))
246 * VCOMPRESS (like LLVM IR [`llvm.masked.compressstore.*`](https://releases.llvm.org/11.0.0/docs/LangRef.html#llvm-masked-compressstore-intrinsics))
247 * VEXPAND (like LLVM IR [`llvm.masked.expandload.*`](https://releases.llvm.org/11.0.0/docs/LangRef.html#llvm-masked-expandload-intrinsics))
248
249 Those patterns (and more) may be applied to:
250
251 * mv (the usual way that V\* operations are created)
252 * exts\* sign-extension
253 * rwlinm and other RS-RA shift operations
254 * LD and ST (treating AGEN as one source)
255 * FP fclass, fsgn, fneg, fabs, fcvt, frecip, fsqrt etc.
256 * Condition Register ops mfcr, mtcr and other similar
257
258 This is a huge list that creates extremely powerful combinations, particularly given that one of the predicate options is `(1<<r3)`
259
260 Additional unusual capabilities of Twin Predication include a back-to-back version of VCOMPRESS-VEXPAND which is effectively the ability to do an ordered multiple VINSERT.
261
262 ## Twin Predication
263
264 There are two different encodings: single-predication (typically arithmetic operations i.e. with more than one source register) and twin-predication (one source, one destination). They require different encodings
265
266 # Register Naming
267
268 SV Registers are numbered using the notation `SV[F|C]R<N>_<M>` where `<N>` is a decimal integer and `<M>` is a binary integer. Two integers are used to enable future register expansions to add more registers by appending more LSB bits to `<M>`.
269
270 For all `SV[F|C]R<N>_<M>` registers, the N is the
271 upper bits in decimal and the M is the lower bits in binary, so `SVR5_01` is
272 SV integer register `(5 << 2) + 0b01`, `SVCR6_011` is SV condition register
273 `(6 << 3) + 0b011`, and `SVFR20_10` is SV floating-point register
274 `(20 << 2) + 0b10`.
275
276 ## Example Code
277
278 a vectorized 32-bit add:
279
280 add SVR3_01, SVR6_10, SVR10_00, elwidth=w, subvl=1, mask=lt
281
282 does the following:
283
284 const size_t start_cr = (6 << 3) + 0b000; // starting at SVCR6_000
285 // pretend for the moment that type-punning actually works in C/C++
286 uint32_t *rt = (uint32_t *)&regs[(3 << 2) + 0b01]; // SVR3_01
287 uint32_t *ra = (uint32_t *)&regs[(6 << 2) + 0b10]; // SVR6_10
288 uint32_t *rb = (uint32_t *)&regs[(10 << 2) + 0b00]; // SVR10_00
289 for(size_t i = 0; i < VL; i++) {
290 if(CRs[(start_cr + i) % 64].lt) {
291 rt[i] = ra[i] + rb[i];
292 }
293 }
294
295 ## Integer Registers
296
297 setvli ..., VL=7
298 add r20, r25, r30, elwidth=64, subvl=1
299
300 where `r20`, `r25`, and `r30` are standard OpenPower register names.
301 Those names correspond to `SVR20_00`, `SVR25_00`, and `SVR30_00`.
302
303 pseudocode:
304
305 const size_t STD_TO_SV_SHIFT = 2; // gets bigger as reg files expand to 256, 512, ... registers
306
307 VL = 7; // setvli (omitting maxvl here)
308
309 for(size_t i = 0; i < VL; i++) {
310 regs[(20 << STD_TO_SV_SHIFT) + i] = regs[(25 << STD_TO_SV_SHIFT) + i]
311 + regs[(30 << STD_TO_SV_SHIFT) + i];
312 }
313
314 Standard PowerISA Integer registers are aliased to some of the SV integer registers:
315
316 (**Jacob these names are impossible to interpret due to them not being sequential numbering and there being no compact algorithm given that shows how they're created. the original SVPrefix was dead easy to understand**)
317
318 | Integer<br/>Register | SV Integer<br/>Register | Integer<br/>Register | SV Integer<br/>Register | Integer<br/>Register | SV Integer<br/>Register | Integer<br/>Register | SV Integer<br/>Register |
319 |----------------------|-------------------------|----------------------|-------------------------|----------------------|-------------------------|----------------------|-------------------------|
320 | R0 | SVR0_00 | R8 | SVR8_00 | R16 | SVR16_00 | R24 | SVR24_00 |
321 | | SVR0_01 | | SVR8_01 | | SVR16_01 | | SVR24_01 |
322 | | SVR0_10 | | SVR8_10 | | SVR16_10 | | SVR24_10 |
323 | | SVR0_11 | | SVR8_11 | | SVR16_11 | | SVR24_11 |
324 | R1 | SVR1_00 | R9 | SVR9_00 | R17 | SVR17_00 | R25 | SVR25_00 |
325 | | SVR1_01 | | SVR9_01 | | SVR17_01 | | SVR25_01 |
326 | | SVR1_10 | | SVR9_10 | | SVR17_10 | | SVR25_10 |
327 | | SVR1_11 | | SVR9_11 | | SVR17_11 | | SVR25_11 |
328 | R2 | SVR2_00 | R10 | SVR10_00 | R18 | SVR18_00 | R26 | SVR26_00 |
329 | | SVR2_01 | | SVR10_01 | | SVR18_01 | | SVR26_01 |
330 | | SVR2_10 | | SVR10_10 | | SVR18_10 | | SVR26_10 |
331 | | SVR2_11 | | SVR10_11 | | SVR18_11 | | SVR26_11 |
332 | R3 | SVR3_00 | R11 | SVR11_00 | R19 | SVR19_00 | R27 | SVR27_00 |
333 | | SVR3_01 | | SVR11_01 | | SVR19_01 | | SVR27_01 |
334 | | SVR3_10 | | SVR11_10 | | SVR19_10 | | SVR27_10 |
335 | | SVR3_11 | | SVR11_11 | | SVR19_11 | | SVR27_11 |
336 | R4 | SVR4_00 | R12 | SVR12_00 | R20 | SVR20_00 | R28 | SVR28_00 |
337 | | SVR4_01 | | SVR12_01 | | SVR20_01 | | SVR28_01 |
338 | | SVR4_10 | | SVR12_10 | | SVR20_10 | | SVR28_10 |
339 | | SVR4_11 | | SVR12_11 | | SVR20_11 | | SVR28_11 |
340 | R5 | SVR5_00 | R13 | SVR13_00 | R21 | SVR21_00 | R29 | SVR29_00 |
341 | | SVR5_01 | | SVR13_01 | | SVR21_01 | | SVR29_01 |
342 | | SVR5_10 | | SVR13_10 | | SVR21_10 | | SVR29_10 |
343 | | SVR5_11 | | SVR13_11 | | SVR21_11 | | SVR29_11 |
344 | R6 | SVR6_00 | R14 | SVR14_00 | R22 | SVR22_00 | R30 | SVR30_00 |
345 | | SVR6_01 | | SVR14_01 | | SVR22_01 | | SVR30_01 |
346 | | SVR6_10 | | SVR14_10 | | SVR22_10 | | SVR30_10 |
347 | | SVR6_11 | | SVR14_11 | | SVR22_11 | | SVR30_11 |
348 | R7 | SVR7_00 | R15 | SVR15_00 | R23 | SVR23_00 | R31 | SVR31_00 |
349 | | SVR7_01 | | SVR15_01 | | SVR23_01 | | SVR31_01 |
350 | | SVR7_10 | | SVR15_10 | | SVR23_10 | | SVR31_10 |
351 | | SVR7_11 | | SVR15_11 | | SVR23_11 | | SVR31_11 |
352
353 ## Floating-Point Registers
354
355 Standard PowerISA floating-point and VSX registers are aliased to some of the SV floating-point registers:
356
357 (**Jacob these names are impossible to interpret due to them not being sequential numbering and there being no compact algorithm given that shows how they're created. the original SVPrefix was dead easy to understand**)
358
359 | FP<br/>Register | VSX Register | SV FP<br/>Register | FP<br/>Register | VSX Register | SV FP<br/>Register |
360 |-----------------|-----------------------|--------------------|-----------------|-----------------------|--------------------|
361 | FPR\[0\] | VSR\[0\]\.dword\[0\] | SVFR0\_00 | FPR\[16\] | VSR\[16\]\.dword\[0\] | SVFR16\_00 |
362 | | VSR\[0\]\.dword\[1\] | SVFR0\_01 | | VSR\[16\]\.dword\[1\] | SVFR16\_01 |
363 | | VSR\[32\]\.dword\[0\] | SVFR0\_10 | | VSR\[48\]\.dword\[0\] | SVFR16\_10 |
364 | | VSR\[32\]\.dword\[1\] | SVFR0\_11 | | VSR\[48\]\.dword\[1\] | SVFR16\_11 |
365 | FPR\[1\] | VSR\[1\]\.dword\[0\] | SVFR1\_00 | FPR\[17\] | VSR\[17\]\.dword\[0\] | SVFR17\_00 |
366 | | VSR\[1\]\.dword\[1\] | SVFR1\_01 | | VSR\[17\]\.dword\[1\] | SVFR17\_01 |
367 | | VSR\[33\]\.dword\[0\] | SVFR1\_10 | | VSR\[49\]\.dword\[0\] | SVFR17\_10 |
368 | | VSR\[33\]\.dword\[1\] | SVFR1\_11 | | VSR\[49\]\.dword\[1\] | SVFR17\_11 |
369 | FPR\[2\] | VSR\[2\]\.dword\[0\] | SVFR2\_00 | FPR\[18\] | VSR\[18\]\.dword\[0\] | SVFR18\_00 |
370 | | VSR\[2\]\.dword\[1\] | SVFR2\_01 | | VSR\[18\]\.dword\[1\] | SVFR18\_01 |
371 | | VSR\[34\]\.dword\[0\] | SVFR2\_10 | | VSR\[50\]\.dword\[0\] | SVFR18\_10 |
372 | | VSR\[34\]\.dword\[1\] | SVFR2\_11 | | VSR\[50\]\.dword\[1\] | SVFR18\_11 |
373 | FPR\[3\] | VSR\[3\]\.dword\[0\] | SVFR3\_00 | FPR\[19\] | VSR\[19\]\.dword\[0\] | SVFR19\_00 |
374 | | VSR\[3\]\.dword\[1\] | SVFR3\_01 | | VSR\[19\]\.dword\[1\] | SVFR19\_01 |
375 | | VSR\[35\]\.dword\[0\] | SVFR3\_10 | | VSR\[51\]\.dword\[0\] | SVFR19\_10 |
376 | | VSR\[35\]\.dword\[1\] | SVFR3\_11 | | VSR\[51\]\.dword\[1\] | SVFR19\_11 |
377 | FPR\[4\] | VSR\[4\]\.dword\[0\] | SVFR4\_00 | FPR\[20\] | VSR\[20\]\.dword\[0\] | SVFR20\_00 |
378 | | VSR\[4\]\.dword\[1\] | SVFR4\_01 | | VSR\[20\]\.dword\[1\] | SVFR20\_01 |
379 | | VSR\[36\]\.dword\[0\] | SVFR4\_10 | | VSR\[52\]\.dword\[0\] | SVFR20\_10 |
380 | | VSR\[36\]\.dword\[1\] | SVFR4\_11 | | VSR\[52\]\.dword\[1\] | SVFR20\_11 |
381 | FPR\[5\] | VSR\[5\]\.dword\[0\] | SVFR5\_00 | FPR\[21\] | VSR\[21\]\.dword\[0\] | SVFR21\_00 |
382 | | VSR\[5\]\.dword\[1\] | SVFR5\_01 | | VSR\[21\]\.dword\[1\] | SVFR21\_01 |
383 | | VSR\[37\]\.dword\[0\] | SVFR5\_10 | | VSR\[53\]\.dword\[0\] | SVFR21\_10 |
384 | | VSR\[37\]\.dword\[1\] | SVFR5\_11 | | VSR\[53\]\.dword\[1\] | SVFR21\_11 |
385 | FPR\[6\] | VSR\[6\]\.dword\[0\] | SVFR6\_00 | FPR\[22\] | VSR\[22\]\.dword\[0\] | SVFR22\_00 |
386 | | VSR\[6\]\.dword\[1\] | SVFR6\_01 | | VSR\[22\]\.dword\[1\] | SVFR22\_01 |
387 | | VSR\[38\]\.dword\[0\] | SVFR6\_10 | | VSR\[54\]\.dword\[0\] | SVFR22\_10 |
388 | | VSR\[38\]\.dword\[1\] | SVFR6\_11 | | VSR\[54\]\.dword\[1\] | SVFR22\_11 |
389 | FPR\[7\] | VSR\[7\]\.dword\[0\] | SVFR7\_00 | FPR\[23\] | VSR\[23\]\.dword\[0\] | SVFR23\_00 |
390 | | VSR\[7\]\.dword\[1\] | SVFR7\_01 | | VSR\[23\]\.dword\[1\] | SVFR23\_01 |
391 | | VSR\[39\]\.dword\[0\] | SVFR7\_10 | | VSR\[55\]\.dword\[0\] | SVFR23\_10 |
392 | | VSR\[39\]\.dword\[1\] | SVFR7\_11 | | VSR\[55\]\.dword\[1\] | SVFR23\_11 |
393 | FPR\[8\] | VSR\[8\]\.dword\[0\] | SVFR8\_00 | FPR\[24\] | VSR\[24\]\.dword\[0\] | SVFR24\_00 |
394 | | VSR\[8\]\.dword\[1\] | SVFR8\_01 | | VSR\[24\]\.dword\[1\] | SVFR24\_01 |
395 | | VSR\[40\]\.dword\[0\] | SVFR8\_10 | | VSR\[56\]\.dword\[0\] | SVFR24\_10 |
396 | | VSR\[40\]\.dword\[1\] | SVFR8\_11 | | VSR\[56\]\.dword\[1\] | SVFR24\_11 |
397 | FPR\[9\] | VSR\[9\]\.dword\[0\] | SVFR9\_00 | FPR\[25\] | VSR\[25\]\.dword\[0\] | SVFR25\_00 |
398 | | VSR\[9\]\.dword\[1\] | SVFR9\_01 | | VSR\[25\]\.dword\[1\] | SVFR25\_01 |
399 | | VSR\[41\]\.dword\[0\] | SVFR9\_10 | | VSR\[57\]\.dword\[0\] | SVFR25\_10 |
400 | | VSR\[41\]\.dword\[1\] | SVFR9\_11 | | VSR\[57\]\.dword\[1\] | SVFR25\_11 |
401 | FPR\[10\] | VSR\[10\]\.dword\[0\] | SVFR10\_00 | FPR\[26\] | VSR\[26\]\.dword\[0\] | SVFR26\_00 |
402 | | VSR\[10\]\.dword\[1\] | SVFR10\_01 | | VSR\[26\]\.dword\[1\] | SVFR26\_01 |
403 | | VSR\[42\]\.dword\[0\] | SVFR10\_10 | | VSR\[58\]\.dword\[0\] | SVFR26\_10 |
404 | | VSR\[42\]\.dword\[1\] | SVFR10\_11 | | VSR\[58\]\.dword\[1\] | SVFR26\_11 |
405 | FPR\[11\] | VSR\[11\]\.dword\[0\] | SVFR11\_00 | FPR\[27\] | VSR\[27\]\.dword\[0\] | SVFR27\_00 |
406 | | VSR\[11\]\.dword\[1\] | SVFR11\_01 | | VSR\[27\]\.dword\[1\] | SVFR27\_01 |
407 | | VSR\[43\]\.dword\[0\] | SVFR11\_10 | | VSR\[59\]\.dword\[0\] | SVFR27\_10 |
408 | | VSR\[43\]\.dword\[1\] | SVFR11\_11 | | VSR\[59\]\.dword\[1\] | SVFR27\_11 |
409 | FPR\[12\] | VSR\[12\]\.dword\[0\] | SVFR12\_00 | FPR\[28\] | VSR\[28\]\.dword\[0\] | SVFR28\_00 |
410 | | VSR\[12\]\.dword\[1\] | SVFR12\_01 | | VSR\[28\]\.dword\[1\] | SVFR28\_01 |
411 | | VSR\[44\]\.dword\[0\] | SVFR12\_10 | | VSR\[60\]\.dword\[0\] | SVFR28\_10 |
412 | | VSR\[44\]\.dword\[1\] | SVFR12\_11 | | VSR\[60\]\.dword\[1\] | SVFR28\_11 |
413 | FPR\[13\] | VSR\[13\]\.dword\[0\] | SVFR13\_00 | FPR\[29\] | VSR\[29\]\.dword\[0\] | SVFR29\_00 |
414 | | VSR\[13\]\.dword\[1\] | SVFR13\_01 | | VSR\[29\]\.dword\[1\] | SVFR29\_01 |
415 | | VSR\[45\]\.dword\[0\] | SVFR13\_10 | | VSR\[61\]\.dword\[0\] | SVFR29\_10 |
416 | | VSR\[45\]\.dword\[1\] | SVFR13\_11 | | VSR\[61\]\.dword\[1\] | SVFR29\_11 |
417 | FPR\[14\] | VSR\[14\]\.dword\[0\] | SVFR14\_00 | FPR\[30\] | VSR\[30\]\.dword\[0\] | SVFR30\_00 |
418 | | VSR\[14\]\.dword\[1\] | SVFR14\_01 | | VSR\[30\]\.dword\[1\] | SVFR30\_01 |
419 | | VSR\[46\]\.dword\[0\] | SVFR14\_10 | | VSR\[62\]\.dword\[0\] | SVFR30\_10 |
420 | | VSR\[46\]\.dword\[1\] | SVFR14\_11 | | VSR\[62\]\.dword\[1\] | SVFR30\_11 |
421 | FPR\[15\] | VSR\[15\]\.dword\[0\] | SVFR15\_00 | FPR\[31\] | VSR\[31\]\.dword\[0\] | SVFR31\_00 |
422 | | VSR\[15\]\.dword\[1\] | SVFR15\_01 | | VSR\[31\]\.dword\[1\] | SVFR31\_01 |
423 | | VSR\[47\]\.dword\[0\] | SVFR15\_10 | | VSR\[63\]\.dword\[0\] | SVFR31\_10 |
424 | | VSR\[47\]\.dword\[1\] | SVFR15\_11 | | VSR\[63\]\.dword\[1\] | SVFR31\_11 |
425
426 # Operation
427
428 ## CR fields as inputs/outputs of vector operations
429
430 When vectorized, the CR inputs/outputs are read/written to 4-bit CR fields
431 starting from SVCR6_000 and incrementing from there. If SVCR7_111 is reached, the next CR
432 field used wraps around to SVCR0_000, then incrementing from there.
433 (see [[discussion]]. some alternative schemes are described there)
434
435 SVCR6_000 was chosen to balance avoiding needing to save CR2-CR4 (which are
436 callee-saved) just to use SV vectors with VL <= 61 as well as having the first
437 vector CR field readily accessible to standard CR instructions and branches.
438 Additionally, SVCR6_000 is used as the implicit result of a OpenPower ISA v3.1
439 standard vector (SIMD) instruction with Rc=1.
440
441 ## Table of CR fields
442
443 CR[i] is the notation used by the OpenPower spec to refer to CR field #i,
444 so FP instructions with Rc=1 write to CR[1] aka SVCR1_000.
445
446 There are 3 new SPRs for holding CRs: CR_EXT1, CR_EXT2, and CR_EXT3.
447
448 The 64 SV CRs are arranged similarly to the way the 128 integer registers are arranged:
449
450 (**Jacob these names are impossible to interpret due to them not being sequential numbering and there being no compact algorithm given that shows how they're created. the original SVPrefix was dead easy to understand**)
451
452 | CR<br/>Register | SPR<br/>Field | SV CR<br/>Register | CR<br/>Register | SPR<br/>Field | SV CR<br/>Register |
453 |-----------------|----------------|--------------------|-----------------|----------------|--------------------|
454 | CR[0] | CR[32:35] | SVCR0_000 | CR[4] | CR[48:51] | SVCR4_000 |
455 | | CR_EXT1[32:35] | SVCR0_001 | | CR_EXT1[48:51] | SVCR4_001 |
456 | | CR_EXT2[32:35] | SVCR0_010 | | CR_EXT2[48:51] | SVCR4_010 |
457 | | CR_EXT3[32:35] | SVCR0_011 | | CR_EXT3[48:51] | SVCR4_011 |
458 | *CR[-8]* | CR[0:3] | SVCR0_100 | *CR[-4]* | CR[16:19] | SVCR4_100 |
459 | | CR_EXT1[0:3] | SVCR0_101 | | CR_EXT1[16:19] | SVCR4_101 |
460 | | CR_EXT2[0:3] | SVCR0_110 | | CR_EXT2[16:19] | SVCR4_110 |
461 | | CR_EXT3[0:3] | SVCR0_111 | | CR_EXT3[16:19] | SVCR4_111 |
462 | CR[1] | CR[36:39] | SVCR1_000 | CR[5] | CR[52:55] | SVCR5_000 |
463 | | CR_EXT1[36:39] | SVCR1_001 | | CR_EXT1[52:55] | SVCR5_001 |
464 | | CR_EXT2[36:39] | SVCR1_010 | | CR_EXT2[52:55] | SVCR5_010 |
465 | | CR_EXT3[36:39] | SVCR1_011 | | CR_EXT3[52:55] | SVCR5_011 |
466 | *CR[-7]* | CR[4:7] | SVCR1_100 | *CR[-3]* | CR[20:23] | SVCR5_100 |
467 | | CR_EXT1[4:7] | SVCR1_101 | | CR_EXT1[20:23] | SVCR5_101 |
468 | | CR_EXT2[4:7] | SVCR1_110 | | CR_EXT2[20:23] | SVCR5_110 |
469 | | CR_EXT3[4:7] | SVCR1_111 | | CR_EXT3[20:23] | SVCR5_111 |
470 | CR[2] | CR[40:43] | SVCR2_000 | CR[6] | CR[56:59] | SVCR6_000 |
471 | | CR_EXT1[40:43] | SVCR2_001 | | CR_EXT1[56:59] | SVCR6_001 |
472 | | CR_EXT2[40:43] | SVCR2_010 | | CR_EXT2[56:59] | SVCR6_010 |
473 | | CR_EXT3[40:43] | SVCR2_011 | | CR_EXT3[56:59] | SVCR6_011 |
474 | *CR[-6]* | CR[8:11] | SVCR2_100 | *CR[-2]* | CR[24:27] | SVCR6_100 |
475 | | CR_EXT1[8:11] | SVCR2_101 | | CR_EXT1[24:27] | SVCR6_101 |
476 | | CR_EXT2[8:11] | SVCR2_110 | | CR_EXT2[24:27] | SVCR6_110 |
477 | | CR_EXT3[8:11] | SVCR2_111 | | CR_EXT3[24:27] | SVCR6_111 |
478 | CR[3] | CR[44:47] | SVCR3_000 | CR[7] | CR[60:63] | SVCR7_000 |
479 | | CR_EXT1[44:47] | SVCR3_001 | | CR_EXT1[60:63] | SVCR7_001 |
480 | | CR_EXT2[44:47] | SVCR3_010 | | CR_EXT2[60:63] | SVCR7_010 |
481 | | CR_EXT3[44:47] | SVCR3_011 | | CR_EXT3[60:63] | SVCR7_011 |
482 | *CR[-5]* | CR[12:15] | SVCR3_100 | *CR[-1]* | CR[28:31] | SVCR7_100 |
483 | | CR_EXT1[12:15] | SVCR3_101 | | CR_EXT1[28:31] | SVCR7_101 |
484 | | CR_EXT2[12:15] | SVCR3_110 | | CR_EXT2[28:31] | SVCR7_110 |
485 | | CR_EXT3[12:15] | SVCR3_111 | | CR_EXT3[28:31] | SVCR7_111 |
486
487 Note: CR[-8] through CR[-1] are not part of OpenPower v3.1, they are the MSB half of the 64-bit CR SPR.
488
489 # Register Profiles
490
491 Instructions are broken down by Register Profiles as listed in the following auto-generated page:
492 [[opcode_regs_deduped]]. "Non-SV" indicates that the operations with this Register Profile cannot be Vectorised (mtspr, bc, dcbz, twi)
493
494 ## LDST-1R-1W-imm
495 TBD
496 ## LDST-1R-2W-imm
497 TBD
498 ## LDST-2R-imm
499 TBD
500 ## LDST-2R-1W
501 TBD
502 ## LDST-2R-1W-imm
503 TBD
504 ## LDST-2R-2W
505 TBD
506 ## LDST-3R
507 TBD
508 ## LDST-3R-CRo
509 TBD
510 ## LDST-3R-1W
511 TBD
512 ## CRio
513 TBD
514 ## CR=2R1W
515
516 Remapped Encoding Fields:
517
518 | `0` | `1:3` | `4:5` | `6:7` | `8:10` | `11:13` | `14:16` | `17:23` |
519 |-----------|-------|---------|-------|-------------|-------------|-------------|---------|
520 | MASK_KIND | MASK | ELWIDTH | SUBVL | Rdest_EXTRA | Rsrc1_EXTRA | Rsrc2_EXTRA | TBD |
521
522 ## 1W-CRi
523
524 Remapped Encoding Fields:
525
526 | `0` | `1:3` | `4:5` | `6:7` | `8:10` | `11:13` | `14:16` | `17:18` | `19:20` | `21:23` |
527 |-----------|-------|---------|-------|-------------|-------------|----------|-------------|-----------|---------|
528 | MASK_KIND | MASK | ELWIDTH | SUBVL | Rdest_EXTRA | Rsrc1_EXTRA | MASK_SRC | ELWIDTH_SRC | SUBVL_SRC | TBD |
529
530 ## 1R-CRo
531
532 Remapped Encoding Fields:
533
534 | `0` | `1:3` | `4:5` | `6:7` | `8:10` | `11:13` | `14:16` | `17:18` | `19:20` | `21:23` |
535 |-----------|-------|---------|-------|-------------|-------------|----------|-------------|-----------|---------|
536 | MASK_KIND | MASK | ELWIDTH | SUBVL | Rdest_EXTRA | Rsrc1_EXTRA | MASK_SRC | ELWIDTH_SRC | SUBVL_SRC | TBD |
537
538 ## 1R-CRio
539
540 Remapped Encoding Fields:
541
542 | `0` | `1:3` | `4:5` | `6:7` | `8:10` | `11:13` | `14:16` | `17:18` | `19:20` | `21:23` |
543 |-----------|-------|---------|-------|-------------|-------------|----------|-------------|-----------|---------|
544 | MASK_KIND | MASK | ELWIDTH | SUBVL | Rdest_EXTRA | Rsrc1_EXTRA | MASK_SRC | ELWIDTH_SRC | SUBVL_SRC | TBD |
545
546 ## 1R-1W
547
548 Remapped Encoding Fields:
549
550 | `0` | `1:3` | `4:5` | `6:7` | `8:10` | `11:13` | `14:16` | `17:18` | `19:20` | `21:23` |
551 |-----------|-------|---------|-------|-------------|-------------|----------|-------------|-----------|---------|
552 | MASK_KIND | MASK | ELWIDTH | SUBVL | Rdest_EXTRA | Rsrc1_EXTRA | MASK_SRC | ELWIDTH_SRC | SUBVL_SRC | TBD |
553
554 ## 1R-1W-imm
555
556 Remapped Encoding Fields:
557
558 | `0` | `1:3` | `4:5` | `6:7` | `8:10` | `11:13` | `14:16` | `17:18` | `19:20` | `21:23` |
559 |-----------|-------|---------|-------|-------------|-------------|----------|-------------|-----------|---------|
560 | MASK_KIND | MASK | ELWIDTH | SUBVL | Rdest_EXTRA | Rsrc1_EXTRA | MASK_SRC | ELWIDTH_SRC | SUBVL_SRC | TBD |
561
562 ## 1R-1W-CRo
563
564 Remapped Encoding Fields:
565
566 | `0` | `1:3` | `4:5` | `6:7` | `8:10` | `11:13` | `14:16` | `17:18` | `19:20` | `21:23` |
567 |-----------|-------|---------|-------|-------------|-------------|----------|-------------|-----------|---------|
568 | MASK_KIND | MASK | ELWIDTH | SUBVL | Rdest_EXTRA | Rsrc1_EXTRA | MASK_SRC | ELWIDTH_SRC | SUBVL_SRC | TBD |
569
570 ## 1R-1W-CRio
571
572 Remapped Encoding Fields:
573
574 | `0` | `1:3` | `4:5` | `6:7` | `8:10` | `11:13` | `14:16` | `17:18` | `19:20` | `21:23` |
575 |-----------|-------|---------|-------|-------------|-------------|----------|-------------|-----------|---------|
576 | MASK_KIND | MASK | ELWIDTH | SUBVL | Rdest_EXTRA | Rsrc1_EXTRA | MASK_SRC | ELWIDTH_SRC | SUBVL_SRC | TBD |
577
578 ## 2R-CRo
579
580 Remapped Encoding Fields:
581
582 | `0` | `1:3` | `4:5` | `6:7` | `8:10` | `11:13` | `14:16` | `17:23` |
583 |-----------|-------|---------|-------|-------------|-------------|-------------|---------|
584 | MASK_KIND | MASK | ELWIDTH | SUBVL | Rdest_EXTRA | Rsrc1_EXTRA | Rsrc2_EXTRA | TBD |
585
586 ## 2R-CRio
587
588 Remapped Encoding Fields:
589
590 | `0` | `1:3` | `4:5` | `6:7` | `8:10` | `11:13` | `14:16` | `17:23` |
591 |-----------|-------|---------|-------|-------------|-------------|-------------|---------|
592 | MASK_KIND | MASK | ELWIDTH | SUBVL | Rdest_EXTRA | Rsrc1_EXTRA | Rsrc2_EXTRA | TBD |
593
594 ## 2R-1W
595
596 Remapped Encoding Fields:
597
598 | `0` | `1:3` | `4:5` | `6:7` | `8:10` | `11:13` | `14:16` | `17:23` |
599 |-----------|-------|---------|-------|-------------|-------------|-------------|---------|
600 | MASK_KIND | MASK | ELWIDTH | SUBVL | Rdest_EXTRA | Rsrc1_EXTRA | Rsrc2_EXTRA | TBD |
601
602 ## 2R-1W-CRo
603
604 Remapped Encoding Fields:
605
606 | `0` | `1:3` | `4:5` | `6:7` | `8:10` | `11:13` | `14:16` | `17:23` |
607 |-----------|-------|---------|-------|-------------|-------------|-------------|---------|
608 | MASK_KIND | MASK | ELWIDTH | SUBVL | Rdest_EXTRA | Rsrc1_EXTRA | Rsrc2_EXTRA | TBD |
609
610 <!-- comment needed to stop ikiwiki markdown from mis-parsing table -->
611
612 ## 2R-1W-CRo (rl(w|d)imi)
613
614 Remapped Encoding Fields:
615
616 | `0` | `1:3` | `4:5` | `6:7` | `8:10` | `11:13` | `14:23` |
617 |-----------|-------|---------|-------|-------------|-------------|---------|
618 | MASK_KIND | MASK | ELWIDTH | SUBVL | Rdest_EXTRA | Rsrc1_EXTRA | TBD |
619
620 ## 2R-1W-CRi
621 TBD
622 ## 2R-1W-CRio
623
624 Remapped Encoding Fields:
625
626 | `0` | `1:3` | `4:5` | `6:7` | `8:10` | `11:13` | `14:16` | `17:23` |
627 |-----------|-------|---------|-------|-------------|-------------|-------------|---------|
628 | MASK_KIND | MASK | ELWIDTH | SUBVL | Rdest_EXTRA | Rsrc1_EXTRA | Rsrc2_EXTRA | TBD |
629
630 ## 3R-1W-CRio
631
632 Remapped Encoding Fields:
633
634 | `0` | `1:3` | `4:5` | `6:7` | `8:10` | `11:13` | `14:16` | `17:19` | `20:23` |
635 |-----------|-------|---------|-------|-------------|-------------|-------------|-------------|----------|
636 | MASK_KIND | MASK | ELWIDTH | SUBVL | Rdest_EXTRA | Rsrc1_EXTRA | Rsrc2_EXTRA | Rsrc3_EXTRA | Reserved |