From 911d17912560a274f1faef33a09882406ab5190a Mon Sep 17 00:00:00 2001
From: "bernard.xiong" <bernard.xiong@gmail.com>
Date: Sat, 20 Mar 2010 15:15:54 +0000
Subject: add more thread example and Chinese comments.

git-svn-id: https://rt-thread.googlecode.com/svn/trunk@519 bbd45198-f89e-11dd-88c7-29a3b14d5316
---
 examples/kernel/thread_dynamic_simple.c | 42 ++++++++++++++++++++++-----------
 1 file changed, 28 insertions(+), 14 deletions(-)

(limited to 'examples/kernel/thread_dynamic_simple.c')

diff --git a/examples/kernel/thread_dynamic_simple.c b/examples/kernel/thread_dynamic_simple.c
index 9f822eefc7..e7f3dfb61b 100644
--- a/examples/kernel/thread_dynamic_simple.c
+++ b/examples/kernel/thread_dynamic_simple.c
@@ -1,35 +1,45 @@
+/*
+ * 程序清单：动态线程
+ *
+ * 这个程序会初始化2个动态线程，它们拥有共同的入口函数，但参数不相同
+ */
 #include <rtthread.h>
 #include "tc_comm.h"
 
-/*
- * This is an example for dynamic thread
- */
-static rt_thread_t tid1 = RT_NULL, tid2 = RT_NULL;
+/* 指向线程控制块的指针 */
+static rt_thread_t tid1 = RT_NULL;
+static rt_thread_t tid2 = RT_NULL;
+/* 线程入口 */
 static void thread_entry(void* parameter)
 {
 	rt_uint32_t count = 0;
-	rt_uint32_t no = (rt_uint32_t) parameter;
+	rt_uint32_t no = (rt_uint32_t) parameter; /* 获得正确的入口参数 */
 
 	while (1)
 	{
+		/* 打印线程计数值输出 */
 		rt_kprintf("thread%d count: %d\n", no, count ++);
+
+		/* 休眠10个OS Tick */
 		rt_thread_delay(10);
 	}
 }
 
 int thread_dynamic_simple_init()
 {
-	tid1 = rt_thread_create("t1",
-		thread_entry, (void*)1,
+	/* 创建线程1 */
+	tid1 = rt_thread_create("thread",
+		thread_entry, RT_NULL, /* 线程入口是thread1_entry, 入口参数是RT_NULL */
 		THREAD_STACK_SIZE, THREAD_PRIORITY, THREAD_TIMESLICE);
 	if (tid1 != RT_NULL)
 		rt_thread_startup(tid1);
 	else
 		tc_stat(TC_STAT_END | TC_STAT_FAILED);
 
-	tid2 = rt_thread_create("t2",
-		thread_entry, (void*)2,
-		THREAD_STACK_SIZE, THREAD_PRIORITY + 1, THREAD_TIMESLICE);
+	/* 创建线程2 */
+	tid2 = rt_thread_create("thread",
+		thread_entry, RT_NULL, /* 线程入口是thread2_entry, 入口参数是RT_NULL */
+		THREAD_STACK_SIZE, THREAD_PRIORITY, THREAD_TIMESLICE);
 	if (tid2 != RT_NULL)
 		rt_thread_startup(tid2);
 	else
@@ -41,31 +51,35 @@ int thread_dynamic_simple_init()
 #ifdef RT_USING_TC
 static void _tc_cleanup()
 {
-	/* lock scheduler */
+	/* 调度器上锁，上锁后，将不再切换到其他线程，仅响应中断 */
 	rt_enter_critical();
 
-	/* delete thread */
+	/* 删除线程 */
 	if (tid1 != RT_NULL && tid1->stat != RT_THREAD_CLOSE)
 		rt_thread_delete(tid1);
 	if (tid2 != RT_NULL && tid2->stat != RT_THREAD_CLOSE)
 		rt_thread_delete(tid2);
 
-	/* unlock scheduler */
+	/* 调度器解锁 */
 	rt_exit_critical();
 
+	/* 设置TestCase状态 */
 	tc_done(TC_STAT_PASSED);
 }
 
 int _tc_thread_dynamic_simple()
 {
-	/* set tc cleanup */
+	/* 设置TestCase清理回调函数 */
 	tc_cleanup(_tc_cleanup);
 	thread_dynamic_simple_init();
 
+	/* 返回TestCase运行的最长时间 */
 	return 100;
 }
+/* 输出函数命令到finsh shell中 */
 FINSH_FUNCTION_EXPORT(_tc_thread_dynamic_simple, a dynamic thread example);
 #else
+/* 用户应用入口 */
 int rt_application_init()
 {
 	thread_dynamic_simple_init();
-- 
cgit v1.3.1