Changes between Version 35 and Version 36 of kernel_syscalls

Timestamp:

Apr 8, 2015, 10:10:52 PM (9 years ago)

Author:

alain

Comment:

--

kernel_syscalls

@@ -6 +6 @@
 
 The [source:soft/giet_vm/giet_kernel/sys_handler.c _syscall_vector] array contains the 64 kernel functions (syscal handlers) defined by the GIET-VM to handle system calls.
+
+== Coprocessors related sys call handlers ==
+
+These functions are used to access coprocessors connected to the VCI network with a ''vci_mwmr_dma'' controller.
+They make the assumption that there is only one hardware coprocessor of a given type in a given cluster, and a coprocessor
+can be identified by the two (cluster_xy , coproc_type) variables. 
+
+The following structure (defined in the stdio.h file) is used to define a specific TO_COPROC / FROM_COPROC channel.
+{{{
+typedef struct giet_coproc_channel
+{
+    unsigned int  channel_mode;    // MWMR / DMA_IRQ / DMA_NO_IRQ
+    unsigned int  buffer_size;     // memory buffer size
+    unsigned int  buffer_vaddr;    // memory buffer virtual address
+    unsigned int  mwmr_vaddr;      // MWMR descriptor virtual address
+    unsigned int  lock_vaddr;      // lock for MWMR virtual address
+} giet_coproc_channel_t;
+}}}
+
+=== 1) int '''_sys_coproc_alloc'''( unsigned int   coproc_type  ,  unsigned int*  coproc_info  ,  unsigned int*  cluster_xy  ) ===
+This function allocates an hardware coprocessor to the calling task.
+ * '''coproc_type''' : requested processor type.
+ * '''coproc_info''' : returns the number of ports (TO_COPROC / FROM_COPROC / CONFIG )
+ * '''cluster_xy''' : returns the cluster coordinates.
+In this implementation, the the requested coprocessor must be in the same cluster as the processor running the calling task.
+
+=== 2) int '''_sys_coproc_release'''( unsigned int cluster_xy  ,  unsigned int coproc_type ) ===
+This function des-allocates a previously allocated coprocessor.
+ * ''' cluster_xy''' : cluster coordinates.
+ * '''coproc_type''' : requested processor type.
+
+=== 3) int '''_sys_coproc_channel_init'''( unsigned int  cluster_xy  ,  unsigned int coproc_type  ,  unsigned int channel ,  giet_coproc_channel_t*  desc ) ===
+This function initializes specific TO_COPROC or FROM_COPROC communication channel.
+ * '''cluster_xy''' : cluster coordinates.
+ * '''coproc_type''' : coprocessor type. 
+ * '''channel''' : channel index.
+ * '''desc''' : pointer on the channel descriptor.
+
+=== 4) int '''_sys_coproc_channel_start'''( unsigned int  cluster_xy  ,  unsigned int coproc_type  ,  unsigned int  channel ) ===
+This function starts a specific TO_COPROC / FROM_COPROC communication channel.
+ * '''cluster_xy''' : cluster coordinates.
+ * '''coproc_type''' : coprocessor type. 
+ * '''channel''' : channel index.
+
+=== 5) int '''_sys_coproc_channel_stop'''( unsigned int  cluster_xy  ,  unsigned int  channel ) ===
+
+=== 6) int '''_sys_coproc_completed'''( unsigned int cluster_xy ) ===
+
 
 
@@ -184 +232 @@
 
 
-