Changes between Version 111 and Version 112 of library_stdio

Timestamp:

Sep 15, 2015, 6:23:30 PM (10 years ago)

Author:

alain

Comment:

--

library_stdio

@@ -1 +1 @@
 = GIET_VM / User-Level System Calls =
 
-The  [source:soft/giet_vm/giet_libs/stdio.c stdio.c] and [source:soft/giet_vm/giet_libs/stdio.h stdio.h] files  define all system calls provided to user applications by the GIET-VM. They are generally prefixed by ''giet_''.
+The  [source:soft/giet_vm/giet_libs/stdio.c stdio.c] and [source:soft/giet_vm/giet_libs/stdio.h stdio.h] files  define all system calls provided to user applications by the GIET-VM. System calls are prefixed by ''giet_''.
 
 [[PageOutline]]
@@ -13 +13 @@
 These system calls access the MIPS32 protected registers CP0_PROCID and CP0_TIME.
 
- === 1) void '''giet_proc_xyp'''( unsigned int* cluster_x, unsigned int* cluster_y unsigned int* lpid )===
-This function returns the processor identifiers (X,Y,P) from the wired global processor index in CP0_PROCID.
- * cluster_x : X cluster coordinate
- * cluster_y : Y cluster coordinate
- * lpid : local processor index
-No error possible, as the fixed format is  gpid = ( ( cluster_x << Y_WIDTH + cluster_y ) << P_WIDTH ) + lpid 
+ === 1) void '''giet_proc_xyp'''( unsigned int* cluster_x, unsigned int* cluster_y unsigned int* p )===
+This function returns the processor identifiers (x,y,p) from the wired global processor index in CP0_PROCID.
+ The <x> and <y> arguments are the the cluster coordinates. The <p> argument is the processor local index.
+The format is CP0_PROCID = ( ( cluster_x << Y_WIDTH + cluster_y ) << P_WIDTH ) + lpid 
 
  === 2) unsigned int '''giet_proctime'''() ===
 This function returns the local processor time from the CP0_TIME register (number of cycles from reset).
-No error possible, as the processor implements a 32 bits wrapping register.
+The processor implements a 32 bits wrapping register.
  
  === 3) unsigned int '''giet_rand'''() ===
 This function returns a pseudo-random value derived from both the CP0_PROCID and CP0_TIME registers.
-No error possible, as the return value is always between 0 & 65535.
+The value is always between 0 & 65535.