Added descriptions

Author: Tharazi97

UNITTESTS/events/equeue/test_equeue.cpp

@@ -26,7 +26,7 @@
 #define DISPATCH_INFINITE -1
 #define ITERATION_TIMES 10
 
-extern unsigned int global_time;
+extern unsigned int equeue_global_time;
 
 class TestEqueue : public testing::Test {
     virtual void SetUp()
@@ -50,8 +50,8 @@ static void simple_func(void *p)
 
 static void sloth_func(void *p)
 {
-    global_time += 10;
-    usleep(10000);
+    // adding to equeue_global_time becouse this simulates that this function takes some time
+    equeue_global_time += 10;
     (*(reinterpret_cast<uint8_t *>(p)))++;
 }
 
@@ -125,8 +125,8 @@ static void nest_func(void *p)
 {
     struct nest *nst = reinterpret_cast<struct nest *>(p);
     equeue_call(nst->q, nst->cb, nst->data);
-    global_time += 10;
-    usleep(10000);
+    // adding to equeue_global_time becouse this simulates that this function takes some time
+    equeue_global_time += 10;
 }
 
 static void *multithread_thread(void *p)
@@ -141,7 +141,6 @@ static void multithread_func(void *p)
     if ((*(reinterpret_cast<uint8_t *>(p))) < 200) {
         (*(reinterpret_cast<uint8_t *>(p)))++;
     }
-    usleep(10);
 }
 
 static void background_func(void *p, int ms)
@@ -171,8 +170,8 @@ static void simple_breaker(void *p)
 {
     struct count_and_queue *caq = reinterpret_cast<struct count_and_queue *>(p);
     equeue_break(caq->q);
-    global_time += 10;
-    usleep(10000);
+    // adding to equeue_global_time becouse this simulates that this function takes some time
+    equeue_global_time += 10;
     caq->p++;
 }
 

UNITTESTS/stubs/EqueuePosix_stub.c

@@ -19,18 +19,21 @@
 
 #if defined(EQUEUE_PLATFORM_POSIX)
 
-#include <time.h>
-#include <sys/time.h>
 #include <errno.h>
 
-unsigned int global_time = 0;
+/*
+ * Using global variable as a simulation of passing time. Use of sleep functions may cause problems with thread preempting, which can lead to bad timings.
+ * This problem does not occur on targets.
+ * This variable is only increased in equeue_sema_wait function and in functions that simulate pass of time.
+ */
+unsigned int equeue_global_time = 0;
 
 // Tick operations
 void equeue_tick_init(void) {}
 
 unsigned equeue_tick(void)
 {
-    return global_time;
+    return equeue_global_time;
 }
 
 
@@ -95,10 +98,11 @@ bool equeue_sema_wait(equeue_sema_t *s, int ms)
             pthread_cond_wait(&s->cond, &s->mutex);
         } else {
             for (int i = 0; i < ms; i++) {
-                global_time++;
+                equeue_global_time++;
             }
+            // If ms == 0 increase time so functions don't get stuck in infinite loops.
             if (ms == 0) {
-                global_time++;
+                equeue_global_time++;
             }
         }
     }