Changeset 657 for trunk/kernel/devices/dev_dma.h

Timestamp:

Mar 18, 2020, 11:16:59 PM (4 years ago)

Author:

alain

Message:

Introduce remote_buf.c/.h & socket.c/.h files.
Update dev_nic.c/.h files.

File:

• trunk/kernel/devices/dev_dma.h (modified) (4 diffs)

trunk/kernel/devices/dev_dma.h

@@ -2 +2 @@
  * dev_dma.h - DMA (Direct Memory Access) generic device API definition.
  *
- * Authors   Alain Greiner  (2016,2017,2018)
+ * Authors   Alain Greiner  (2016,2017,2018,2019,2020)
  *
  * Copyright (c) UPMC Sorbonne Universites
@@ -36 +36 @@
  * to/from remote clusters. The burst size is defined by the cache line size.
  * Each DMA channel is described by a specific chdev descriptor, handling its private
- * waiting threads queue. It implement one single command : move data from a (remote)
- * source buffer to a (remote) destination buffer.
+ * waiting threads queue. It implements two blocking commands :
+ * - move synchronously data from a remote source buffer to a remote destination buffer,
+ *   using a polling policy to wait completion (No DMA_IRQ use).
+ * - move synchronously data from a remote source buffer to a remote destination buffer,
+ *   using a descheduling policy to wait completion (reactivated bythe IDMA_IRQ).
  ****************************************************************************************/
  
@@ -50 +53 @@
 typedef struct dma_command_s
 {
-    xptr_t      dev_xp;    /*! extended pointer on the DMA chdev descriptor             */
+    bool_t      sync;      /*! polling policy if true / descheduling policy if false     */
+    xptr_t      dev_xp;    /*! extended pointer on the DMA chdev descriptor              */
     xptr_t      src_xp;    /*! extended pointer on source buffer.                        */
     xptr_t      dst_xp;    /*! extended pointer on destination buffer.                   */
@@ -83 +87 @@
 /*****************************************************************************************
  * This blocking function register a DMA request in the device queue.
- * It uses a descheduling policy to wait completion, and return an error status
- * when the transfer is completed.
+ * It uses a descheduling policy to wait completion, 
+ * It return an error status when the transfer is completed.
  *****************************************************************************************
- * @ dst        : extended pointer on destination buffer.
- * @ src        : extended pointer on Rsource buffer.
+ * @ dst_xp     : extended pointer on destination buffer.
+ * @ src_xp     : extended pointer on source buffer.
  * @ size       : number of bytes to move.
  ****************************************************************************************/
-error_t dev_dma_remote_memcpy( xptr_t     dst_xp,
-                               xptr_t     src_xp,
-                               uint32_t   size );    
+error_t dev_dma_async_memcpy( xptr_t     dst_xp,
+                              xptr_t     src_xp,
+                              uint32_t   size );    
+
+/*****************************************************************************************
+ * This blocking function register a DMA request in the device queue.
+ * It uses a polling policy to wait completion.
+ * It return an error status when the transfer is completed.
+ *****************************************************************************************
+ * @ dst_xp     : extended pointer on destination buffer.
+ * @ src_xp     : extended pointer on source buffer.
+ * @ size       : number of bytes to move.
+ ****************************************************************************************/
+error_t dev_dma_sync_memcpy( xptr_t     dst_xp,
+                             xptr_t     src_xp,
+                             uint32_t   size );