habanalabs: add h/w queues module

This patch adds the H/W queues module and the code to initialize Goya's
various compute and DMA engines and their queues.

Goya has 5 DMA channels, 8 TPC engines and a single MME engine. For each
channel/engine, there is a H/W queue logic which is used to pass commands
from the user to the H/W. That logic is called QMAN.

There are two types of QMANs: external and internal. The DMA QMANs are
considered external while the TPC and MME QMANs are considered internal.
For each external queue there is a completion queue, which is located on
the Host memory.

The differences between external and internal QMANs are:

1. The location of the queue's memory. External QMANs are located on the
   Host memory while internal QMANs are located on the on-chip memory.

2. The external QMAN write an entry to a completion queue and sends an
   MSI-X interrupt upon completion of a command buffer that was given to
   it. The internal QMAN doesn't do that.

Reviewed-by: Mike Rapoport <rppt@linux.ibm.com>
Signed-off-by: Oded Gabbay <oded.gabbay@gmail.com>
Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>

1 files changed, 29 insertions, 0 deletions

diff --git a/include/uapi/misc/habanalabs.h b/include/uapi/misc/habanalabs.h
index a8edfd3e9c95..756266cf0416 100644
--- a/include/uapi/misc/habanalabs.h
+++ b/include/uapi/misc/habanalabs.h
@@ -17,6 +17,35 @@
  */
 #define GOYA_KMD_SRAM_RESERVED_SIZE_FROM_START  0x8000  /* 32KB */
 
+/*
+ * Queue Numbering
+ *
+ * The external queues (DMA channels + CPU) MUST be before the internal queues
+ * and each group (DMA channels + CPU and internal) must be contiguous inside
+ * itself but there can be a gap between the two groups (although not
+ * recommended)
+ */
+
+enum goya_queue_id {
+        GOYA_QUEUE_ID_DMA_0 = 0,
+        GOYA_QUEUE_ID_DMA_1,
+        GOYA_QUEUE_ID_DMA_2,
+        GOYA_QUEUE_ID_DMA_3,
+        GOYA_QUEUE_ID_DMA_4,
+        GOYA_QUEUE_ID_CPU_PQ,
+        GOYA_QUEUE_ID_MME,
+        GOYA_QUEUE_ID_TPC0,
+        GOYA_QUEUE_ID_TPC1,
+        GOYA_QUEUE_ID_TPC2,
+        GOYA_QUEUE_ID_TPC3,
+        GOYA_QUEUE_ID_TPC4,
+        GOYA_QUEUE_ID_TPC5,
+        GOYA_QUEUE_ID_TPC6,
+        GOYA_QUEUE_ID_TPC7,
+        GOYA_QUEUE_ID_SIZE
+};
+
+
 /* Opcode to create a new command buffer */
 #define HL_CB_OP_CREATE         0
 /* Opcode to destroy previously created command buffer */