Changes between Version 4 and Version 5 of common_utils

Timestamp:

Aug 12, 2014, 1:26:22 PM (11 years ago)

Author:

alain

Comment:

--

common_utils

@@ -1 +1 @@
 = Kernel Utilities =
 
-The [source:soft/giet_vm/giet_common/utils.c utils.c] and [source:soft/giet_vm/giet_common/utils.h util.h] files define useful kernel functions, that are used both by the boot_loader and by the kernel. 
+The [source:soft/giet_vm/giet_common/utils.c utils.c] and [source:soft/giet_vm/giet_common/utils.h util.h] files define kernel functions that are used both by the boot_loader and by the kernel. 
 They are prefixed by ''_'' to remind that they can only be executed by a processor in kernel mode.
 
@@ -87 +87 @@
 If the MMU is not activated, the virtual address is extended using X_IO and Y_IO (defined in the hard-config.h file) to reach the cluster_io.
 
+ == __4) SpinLock access functions__ ==
+
+The ''giet_lock_t'' structure is defined in the ''utils.h'' file to have one single lock in a 64 bytes cache line.
+
+ === _get_lock( giet_lock_t lock ) ===
+Takes a lock with a blocking ll/sc atomic access. If the cache coherence is granted by the hardware,
+the first read is a standard (cacheable) lw, as the local copy can be polled when the lock is already taken by another task, reducing trafic on the interconnect. When the lock is released by the owner task, the local copy is updated or invalidated by the coherence protocol. If there is no hardware cache coherence a pseudo random delay is introduced between two successive retry.
+
+ === _release_lock( giet_lock_t lock ) ===
+Releases (or initializes) a lock.
+
  == __X) Miscelaneous functions__ ==