Changes between Version 51 and Version 52 of library_stdio

Timestamp:

Mar 2, 2015, 11:40:17 AM (9 years ago)

Author:

alain

Comment:

--

library_stdio

@@ -11 +11 @@
 Therefore, for all these system calls, the return value has not to be tested by the calling task.
 
- == Processor related system calls ==
+ == __Processor related system calls__ ==
 
  === 1) void '''giet_proc_xyp'''( unsigned int* cluster_x, unsigned int* cluster_y unsigned int* lpid )===
@@ -28 +28 @@
 No error possible, as the return value is always between 0 & 65535.
 
- == Task related system calls ==
+ == __Task related system calls__ ==
 
  === 1) unsigned int '''giet_proc_task_id'''() ===
@@ -43 +43 @@
 No error possible.
 
- ==  Coprocessors related system calls ==
+ ==  __Coprocessors related system calls__ ==
 
 The GIET_VM allows user applications to use hardware accelerators, called coprocessors. These coprocessors can be distributed in the architecture, but there is at most one coprocessor per cluster. To be supported by the GIET_VM, a coprocessor must use the ''vci_mwmr_dma'' component, that is a multi-channels DMA controller.
@@ -76 +76 @@
  
  === 2) void '''giet_coproc_channel_init'''( unsigned int  cluster_xy,  unsigned int channel,  giet_coproc_channel_t*  desc ) ===
+This function initializes a communication channel. It uses the he following structure (defined in the [source:soft/giet_vm/giet_libs/stdio.h stdio.h] file) to specicy the channel parameters:
+{{{
+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;
+}}}
+ * '''cluster_xy''' cluster coordinates
+ * '''channel''' communication channel index
+ * '''desc''' pointer on the giet_coproc_channel_t structure
 
  === 3) void '''giet_coproc_channel_start'''( unsigned int  cluster_xy,  unsigned int    channel ) ===
 
  === 4) void '''giet_coproc_channel_stop'''( unsigned int  cluster_xy,   unsigned int  channel ) ===
+
+ === 5) void '''giet_coproc_completed'''( unsigned int cluster_xy ) ===
+This blocking function can be used to synchronize a software task with an hardware coprocessor running in DMA mode.
+It polls the ''_coproc_done[x][y]'' kernel variable, and returns only when this variable has been set by the ISR associated to  coprocessor in cluster[x][y].