[rtt] Add example "RttMutex"

Author: onelife

examples/RttMutex/RttMutex.ino

@@ -0,0 +1,71 @@
+#include <rtt.h>
+
+// NOTES: "CONFIG_USING_SPISD" in "rtconfig.h" may be turned off to save memory
+
+#define THREAD_NUM 3
+#define STACK_SIZE 256
+
+struct rt_mutex lock;
+
+// user thread entry function
+void thread_entry(void* parameter) {
+  unsigned int i = (unsigned int)parameter;
+
+  rt_kprintf("Thread %d started\n", i);
+
+  rt_kprintf("Thread %d tries to take mutex\n", i);
+  rt_mutex_take(&lock, RT_WAITING_FOREVER);
+  rt_kprintf("Thread %d took mutex\n", i);
+
+  rt_kprintf("Thread %d goes to sleep\n", i);
+  rt_thread_sleep(RT_TICK_PER_SECOND);
+  rt_kprintf("Thread %d woken up\n", i);
+
+  rt_mutex_release(&lock);
+  rt_kprintf("Thread %d released mutex\n", i);
+
+  rt_kprintf("Thread %d exits\n", i);
+  rt_thread_yield();
+}
+
+// RT-Thread function called by "RT_T.begin()"
+void rt_setup(void) {
+  unsigned int i;
+  char name[] = "thread_x";
+  rt_thread_t tid[THREAD_NUM];
+
+  // dynamically initialize threads
+  for (i = 0; i < THREAD_NUM; i++) {
+    name[7] = '1' + i;
+    if (RT_NULL == (tid[i] = rt_thread_create(
+        name,                       // [in] thread name
+        thread_entry,               // [in] thread entry function
+        (void *)i,                  // [in] thread parameter (for entry function)
+        STACK_SIZE,                 // [in] thread stack size
+        10,                         // [in] thread priority
+        20))) {                     // [in] thread ticks
+      rt_kprintf("Failed to create thread %d!\n", i);
+      return;
+    }
+  }
+
+  // statically initialize mutex
+  if (RT_EOK != rt_mutex_init(&lock, "lock", RT_IPC_FLAG_FIFO)) {
+    rt_kprintf("Failed to initialize mutex!\n");
+    return;
+  }
+
+  // start threads
+  for (i = 0; i < THREAD_NUM; i++) {
+    rt_thread_startup(tid[i]);
+  }
+}
+
+void setup() {
+  RT_T.begin();
+}
+
+// this function will be called by "Arduino" thread
+void loop() {
+  // may put some code here that will be run repeatedly
+}

keywords.txt

@@ -59,6 +59,19 @@ rt_thread_resume			KEYWORD2
 rt_thread_timeout			KEYWORD2
 rt_thread_sleep				KEYWORD2
 
+#######################################
+# IPC
+#######################################
+rt_mutex_create				KEYWORD2
+rt_mutex_init				KEYWORD2
+rt_mutex_take				KEYWORD2
+rt_mutex_release			KEYWORD2
+
+#######################################
+# DFS
+#######################################
+fsync						KEYWORD2
+
 #######################################
 # Instances (KEYWORD2)
 #######################################
@@ -73,6 +86,7 @@ CONFIG_KERNEL_PRIORITY		LITERAL1
 CONFIG_USING_CONSOLE		LITERAL1
 CONFIG_USING_FINSH			LITERAL1
 CONFIG_SERIAL_DEVICE		LITERAL1
+RT_NULL						LITERAL1
 RT_EOK						LITERAL1
 RT_ERROR					LITERAL1
 RT_ETIMEOUT					LITERAL1
@@ -84,3 +98,7 @@ RT_EBUSY					LITERAL1
 RT_EIO						LITERAL1
 RT_EINTR					LITERAL1
 RT_EINVAL					LITERAL1
+RT_IPC_FLAG_FIFO			LITERAL1
+RT_IPC_FLAG_PRIO			LITERAL1
+RT_WAITING_FOREVER			LITERAL1
+RT_WAITING_NO				LITERAL1