X-Git-Url: https://git.libre-soc.org/?a=blobdiff_plain;f=llvm_vector_backend.mdwn;h=4f1db0f16b0c808f877d76f1f0fcaf651a0904c5;hb=ffa96d22ab597cd53cc3f0f121af750c036ccd17;hp=e7814becf4c8cb9ec72745fc6d129bca92a08d8d;hpb=6fa3f1db0c5227dac6382be95d2ae48f869c5c57;p=libreriscv.git

diff --git a/llvm_vector_backend.mdwn b/llvm_vector_backend.mdwn
index e7814becf..4f1db0f16 100644
--- a/llvm_vector_backend.mdwn
+++ b/llvm_vector_backend.mdwn
@@ -1,5 +1,18 @@
 # LLVM Backend Array Register Files
 
+This backend is for expressing scenarios where registers have multiple
+potential overlapping meanings and uses, including but not limited to:
+
+* **MMX / SSE / SIMD**: same registers of fixed length can be subdivided into
+  multiple different SIMD elements, depending on the opcode used (or
+  special CSRs - Control Status Registers)
+* **Virtual register redirection**: setting a CSR changes
+  the meaning of instruction opcodes to access different "banks".
+* **Special register types**: expression of special register types,
+  not just integer and float, but shader types for use in 3D, or
+  Galois Field (GF).
+* Variations and combinations of the above
+
 # Data Structures
 
 ## Array Register File
@@ -17,6 +30,7 @@ Examples:
 
     ARF1 = 0x01009005
     ARF2 = 0x0100a006
+    ARF3 = 0x0100b008
 
 These would indicate that when the (virtual) register ARF1 is used,
 it is of type "integer", and it requires the reservation of the **real**
@@ -32,6 +46,21 @@ registers 5 through 9 at the hardware level.
         align: 4;  // an aligment restriction, in powers of 2.
     } BRC;
 
+Examples:
+
+    A Compressed instruction from SV has restrictions on the
+    range it may cover (unless redirection is taken into account).
+    It is also possible to specify a bitwidth of 16, and if that is
+    done, alignment has to be restricted to 4.  So:
+
+    brc1 = {
+        arf = 0x0100b008; // integer register, using "real" regs 8-11 inclusive
+        min = 8;          // C-type instructions go from 8-15 in the opcode
+        max = 15;
+        size = 0x1        // 1=16-bit (?)
+        align: 2          // 2= 1<<2 (=4) because the "real" regs are 64-bit.
+    };
+
 ## Register Class Unions
 
 Register Classes are the union of multiple Base Register Classes
@@ -44,23 +73,17 @@ and uses to which registers may be put can be expressed in one structure.
 
 ### SimpleV
 
-### RVV
-
 ### AMDGPU
 
 ## Base Register Class
 
 ### SimpleV
 
-### RVV
-
 ### AMDGPU
 
 ## Register Class Unions
 
 ### SimpleV
 
-### RVV
-
 ### AMDGPU