summaryrefslogtreecommitdiff
path: root/examples
diff options
context:
space:
mode:
authorguozhanxin <[email protected]>2021-07-12 10:14:20 +0800
committerguozhanxin <[email protected]>2021-07-12 10:14:20 +0800
commit40e7d5a23df65c15bb7db53fe5f77e76701fd20d (patch)
tree4973b28b01d289dd596a097a7560f26b810db771 /examples
parentddc5c793a482fe44310bafe181802ad406fa1b29 (diff)
parent5bae565f7f021ab13113fc0a9c67fc468d97de02 (diff)
Merge remote-tracking branch 'remotes/gitee/master'
Diffstat (limited to 'examples')
-rw-r--r--examples/file/listdir.c9
-rw-r--r--examples/libc/ex3.c2
-rw-r--r--examples/libc/ex6.c2
-rw-r--r--examples/libc/ex7.c2
-rw-r--r--examples/libc/file.c2
-rw-r--r--examples/libc/memory.c2
-rw-r--r--examples/rt-link/rtlink_example.c187
-rw-r--r--examples/test/rtc_test.c8
-rw-r--r--examples/utest/README.md73
-rw-r--r--examples/utest/configs/kernel/mem.conf4
-rw-r--r--examples/utest/configs/utest_self/self.conf1
-rw-r--r--examples/utest/testcases/Kconfig16
-rw-r--r--examples/utest/testcases/SConscript15
-rw-r--r--examples/utest/testcases/drivers/SConscript15
-rw-r--r--examples/utest/testcases/drivers/serial_v2/Kconfig7
-rw-r--r--examples/utest/testcases/drivers/serial_v2/README.md120
-rw-r--r--examples/utest/testcases/drivers/serial_v2/SConscript16
-rw-r--r--examples/utest/testcases/drivers/serial_v2/uart_rxb_txb.c230
-rw-r--r--examples/utest/testcases/drivers/serial_v2/uart_rxb_txnb.c263
-rw-r--r--examples/utest/testcases/drivers/serial_v2/uart_rxnb_txb.c266
-rw-r--r--examples/utest/testcases/drivers/serial_v2/uart_rxnb_txnb.c294
-rw-r--r--examples/utest/testcases/kernel/Kconfig8
-rw-r--r--examples/utest/testcases/kernel/SConscript15
-rw-r--r--examples/utest/testcases/kernel/memheap_tc.c100
-rw-r--r--examples/utest/testcases/utest/Kconfig7
-rw-r--r--examples/utest/testcases/utest/SConscript13
-rw-r--r--examples/utest/testcases/utest/pass_tc.c46
27 files changed, 1711 insertions, 12 deletions
diff --git a/examples/file/listdir.c b/examples/file/listdir.c
index 98fbc5ea2c..06c746a642 100644
--- a/examples/file/listdir.c
+++ b/examples/file/listdir.c
@@ -13,7 +13,7 @@
void list_dir(const char* path)
{
- char * fullpath;
+ char * fullpath = RT_NULL;
DIR *dir;
dir = opendir(path);
@@ -57,7 +57,10 @@ void list_dir(const char* path)
rt_kprintf("open %s directory failed\n", path);
}
- rt_free(fullpath);
+ if (RT_NULL != fullpath)
+ {
+ rt_free(fullpath);
+ }
}
#ifdef RT_USING_FINSH
@@ -80,6 +83,6 @@ static void cmd_list_dir(int argc, char *argv[])
}
list_dir(filename);
}
-FINSH_FUNCTION_EXPORT_ALIAS(cmd_list_dir, __cmd_list_dir, list directory);
+MSH_CMD_EXPORT_ALIAS(cmd_list_dir, list_dir, list directory);
#endif /* FINSH_USING_MSH */
#endif /* RT_USING_FINSH */
diff --git a/examples/libc/ex3.c b/examples/libc/ex3.c
index 1697e7145b..615ed8f35c 100644
--- a/examples/libc/ex3.c
+++ b/examples/libc/ex3.c
@@ -9,7 +9,7 @@
/* Multi-thread searching.
Illustrates: thread cancellation, cleanup handlers. */
-#include <errno.h>
+#include <sys/errno.h>
#include <stdio.h>
#include <unistd.h>
#include <stdlib.h>
diff --git a/examples/libc/ex6.c b/examples/libc/ex6.c
index ac6319d74c..ba687aa46f 100644
--- a/examples/libc/ex6.c
+++ b/examples/libc/ex6.c
@@ -6,7 +6,7 @@
* Change Logs:
* Date Author Notes
*/
-#include <errno.h>
+#include <sys/errno.h>
#include <stdio.h>
#include <string.h>
#include <pthread.h>
diff --git a/examples/libc/ex7.c b/examples/libc/ex7.c
index e885f79c57..d1f05dbdcd 100644
--- a/examples/libc/ex7.c
+++ b/examples/libc/ex7.c
@@ -11,7 +11,7 @@
* Test case that illustrates a timed wait on a condition variable.
*/
-#include <errno.h>
+#include <sys/errno.h>
#include <stdio.h>
#include <string.h>
#include <pthread.h>
diff --git a/examples/libc/file.c b/examples/libc/file.c
index 79cdce3092..878d3a98d7 100644
--- a/examples/libc/file.c
+++ b/examples/libc/file.c
@@ -11,7 +11,7 @@
#include <stdio.h>
#include <stdlib.h>
#include <finsh.h>
-#include <errno.h>
+#include <sys/errno.h>
#include <sys/fcntl.h>
#include <sys/stat.h>
diff --git a/examples/libc/memory.c b/examples/libc/memory.c
index 063d90cfdc..4a31b69017 100644
--- a/examples/libc/memory.c
+++ b/examples/libc/memory.c
@@ -11,7 +11,7 @@
#include <stdio.h>
#include <stdlib.h>
#include <finsh.h>
-#include <errno.h>
+#include <sys/errno.h>
static int errors = 0;
static void merror(const char *msg)
diff --git a/examples/rt-link/rtlink_example.c b/examples/rt-link/rtlink_example.c
new file mode 100644
index 0000000000..841e56b17e
--- /dev/null
+++ b/examples/rt-link/rtlink_example.c
@@ -0,0 +1,187 @@
+
+/*
+ * Copyright (c) 2006-2021, RT-Thread Development Team
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Change Logs:
+ * Date Author Notes
+ * 2021-05-15 Sherman the first version
+ */
+
+#include <stdlib.h>
+#include <string.h>
+#include <rtthread.h>
+#include <rtlink.h>
+
+#define DBG_ENABLE
+#define DBG_TAG "rtlink_exam"
+#define DBG_LVL DBG_INFO
+#include <rtdbg.h>
+
+#define TEST_CONTEXT "This message is sent by RT-Link"
+
+enum
+{
+ NONE_TEST = 0,
+ SHORT_FRAME_TEST,
+ LONG_FRAME_TEST
+};
+
+void rt_link_speed_test(void *paremeter);
+static rt_uint8_t speed_test_type = NONE_TEST;
+
+rt_err_t rt_link_receive_example_callback(void *data, rt_size_t length)
+{
+ LOG_I("recv data %d",length);
+ LOG_HEX("example",8,data,length);
+ rt_free(data);
+ return RT_EOK;
+}
+
+void create_thead_to_test_speed(rt_uint8_t mutil_num)
+{
+ rt_uint8_t i = 0;
+
+ LOG_D("Speed test type [%02d], mutil [%02d]", speed_test_type, mutil_num);
+ for(i = 0; i< mutil_num; i++)
+ {
+ rt_thread_t tid;
+ char tid_name[RT_NAME_MAX + 1] = {0};
+
+ rt_snprintf(tid_name, sizeof(tid_name), "lny_s%03d", i + 1);
+ tid = rt_thread_create(tid_name, rt_link_speed_test, RT_NULL, 1024, 20, 10);
+ rt_thread_startup(tid);
+ LOG_I("Speed test thread[%s] startup", tid_name);
+ }
+}
+
+void rt_link_speed_test(void *paremeter)
+{
+ int ret;
+ rt_uint8_t *send_buf, *data;
+ rt_size_t bufflen = 0;
+ rt_size_t sentlen = 0;
+ rt_size_t count = 0;
+ rt_tick_t tick1, tick2;
+ rt_size_t total = 0;
+ rt_uint32_t integer, decimal;
+
+ if(speed_test_type == SHORT_FRAME_TEST)
+ {
+ bufflen = 2044;
+ }
+ else
+ {
+ bufflen = 6132;
+ }
+
+ send_buf = rt_malloc(bufflen);
+ if(send_buf != RT_NULL)
+ {
+ data = send_buf;
+ for(count = 0;count < bufflen; count++)
+ {
+ *data++ = (count % 93 + 33);
+ }
+ }
+ else
+ {
+ rt_kprintf("speed of send buffer malloc failed.");
+ return;
+ }
+
+ tick1 = rt_tick_get();
+ while (speed_test_type)
+ {
+ ret = rt_link_send(RT_LINK_SERVICE_RTLINK, send_buf, bufflen);
+ if(ret > 0)
+ {
+ sentlen += ret;
+ }
+
+ tick2 = rt_tick_get();
+ if (tick2 - tick1 >= RT_TICK_PER_SECOND)//* 10
+ {
+ total = sentlen * RT_TICK_PER_SECOND / 125 / (tick2 - tick1);
+ integer = total/1000;
+ decimal = total%1000;
+ LOG_I("%d.%03d0 Mbps!", integer, decimal);
+ sentlen = 0;
+ tick1 = tick2;
+ }
+ }
+ rt_free(send_buf);
+ LOG_W("speed test end, type %d",speed_test_type);
+}
+
+int rt_link_example_send(int argc, char **argv)
+{
+ char *receive = RT_NULL;
+ rt_size_t length = 0;
+ rt_uint16_t count = 0;
+
+ if(argc == 1)
+ {
+ receive = rt_malloc(sizeof(TEST_CONTEXT));
+ rt_memcpy(receive, TEST_CONTEXT, sizeof(TEST_CONTEXT) - 1);
+ length = rt_link_send(RT_LINK_SERVICE_RTLINK, receive, sizeof(TEST_CONTEXT) - 1);
+ LOG_I("send data length: %d.", length);
+ rt_free(receive);
+ }
+ else if(argc >= 3)
+ {
+ if(strcmp(argv[1], "-l") == 0)
+ {
+ receive = rt_malloc(atoi((const char *)argv[2]));
+ for(count = 0;count < atoi((const char *)argv[2]); count++)
+ {
+ *receive++ = (count % 93 + 33);
+ }
+ length = rt_link_send(RT_LINK_SERVICE_RTLINK, receive - atoi((const char *)argv[2]), atoi((const char *)argv[2]));
+ rt_free(receive - atoi((const char *)argv[2]));
+
+ LOG_I("send data length: %d.", length);
+ }
+ else if(strcmp(argv[1], "-s") == 0)
+ {
+ if(speed_test_type == NONE_TEST)
+ {
+ rt_uint8_t mutil_num = 1;
+ if(argc > 3)
+ {
+ mutil_num = atoi((const char *)argv[3]);
+ }
+
+ if(strncmp(argv[2], "-s", rt_strlen(argv[2])) == 0)
+ {
+ speed_test_type = SHORT_FRAME_TEST;
+ }
+ else if(strncmp(argv[2], "-l", rt_strlen(argv[2])) == 0)
+ {
+ speed_test_type = LONG_FRAME_TEST;
+ }
+ create_thead_to_test_speed(mutil_num);
+ }
+ else
+ {
+ speed_test_type = NONE_TEST;
+ LOG_I("set NONE_TEST");
+ }
+ }
+ else
+ {
+ LOG_E("Invalid parameter.");
+ }
+ }
+ return 0;
+}
+MSH_CMD_EXPORT(rt_link_example_send, rt link layer send test);
+
+int rt_link_example_init(void)
+{
+
+ rt_link_service_attach(RT_LINK_SERVICE_RTLINK, rt_link_receive_example_callback);
+ return RT_EOK;
+}
+MSH_CMD_EXPORT(rt_link_example_init, rt link layer example init);
diff --git a/examples/test/rtc_test.c b/examples/test/rtc_test.c
index 4ed1349de4..79ea8450f9 100644
--- a/examples/test/rtc_test.c
+++ b/examples/test/rtc_test.c
@@ -20,7 +20,7 @@ int rtc_test(void)
rt_kprintf("[RTC Test]RTC Test Start...\n");
rt_thread_delay(RT_TICK_PER_SECOND);
- rt_kprintf("[RTC Test]Set RTC 2017-04-01 12:30:46\n\n");
+ rt_kprintf("[RTC Test]Set RTC 2017-04-01 12:30:46\n");
rt_thread_delay(RT_TICK_PER_SECOND);
ret = set_date(2017, 4, 1);
@@ -45,7 +45,7 @@ int rtc_test(void)
{
rt_kprintf("[RTC Test]Read RTC Date and Time: ");
now = time(RT_NULL);
- rt_kprintf("%s", ctime(&now));
+ rt_kprintf("%s\n", ctime(&now));
rt_thread_delay(RT_TICK_PER_SECOND);
}
@@ -56,6 +56,6 @@ int rtc_test(void)
}
#ifdef RT_USING_FINSH
#include <finsh.h>
-FINSH_FUNCTION_EXPORT(rtc_test, rtc drive test. e.g: rtc_test());
-MSH_CMD_EXPORT(rtc_test, rtc drive test. e.g: rtc_test());
+FINSH_FUNCTION_EXPORT(rtc_test, rtc driver test. e.g: rtc_test());
+MSH_CMD_EXPORT(rtc_test, rtc driver test. e.g: rtc_test());
#endif
diff --git a/examples/utest/README.md b/examples/utest/README.md
new file mode 100644
index 0000000000..bde3bd4b80
--- /dev/null
+++ b/examples/utest/README.md
@@ -0,0 +1,73 @@
+# RT-Thread 测试用例集合
+
+## 简介
+
+为了保证某一部分代码的质量,通常可以通过编写测试用例的方式,验证此代码的功能。为了保证 RT-Thread 相关仓库的代码质量,我们基于 utest 框架搭建了一套简易的自动化测试环境。有兴趣,有精力的小伙伴可以利用这套机制完善自己的代码检查。如果有意愿让社区上更多的小伙伴收益,也可以在提交代码的时候,把对应的测试用例也提交上来。
+
+## 目录结构
+
+| 目录 | 用途 |
+| --------- | ------------------------------------------------------------ |
+| configs | 配置文件集合(每一个目录代表一种功能集合,如:kernel,net等) |
+| testcases | 测试用例源代码 |
+
+## 如何贡献
+
+### 1. 编写测试用例
+
+参考已有的测试用例在 [examples\utest\testcases](./testcases) 目录下添加自己的测试用例。测试用例的编写方法参考文档中心《utest 测试框架》章节。
+
+### 2. 本地测试
+
+1. 在 `bsp\qemu-vexpress-a9` 目录下打开 `menuconfig`,使能对应的测试用例,如下:
+
+```
+RT-Thread Utestcases --->
+ [*] RT-Thread Utestcases
+ Utest Self Testcase --->
+ [*] Pass test
+```
+
+2. 保存并退出,输入 scons 编译当前 bsp。
+
+3. 输入 .\qemu.bat 运行当前 bsp,在 msh 环境下执行 utest_run 命令,验证代码运行是否正常。
+
+```
+msh />utest_run
+[I/utest] [==========] [ utest ] loop 1/1
+[I/utest] [==========] [ utest ] started
+[I/utest] [----------] [ testcase ] (testcases.utest.pass_tc) started
+[D/utest] [ OK ] [ unit ] (test_assert_pass:16) is passed
+[D/utest] [ OK ] [ unit ] (test_assert_pass:17) is passed
+[D/utest] [ OK ] [ unit ] (test_assert_pass:19) is passed
+[D/utest] [ OK ] [ unit ] (test_assert_pass:20) is passed
+[D/utest] [ OK ] [ unit ] (test_assert_pass:22) is passed
+[D/utest] [ OK ] [ unit ] (test_assert_pass:23) is passed
+[D/utest] [ OK ] [ unit ] (test_assert_pass:25) is passed
+[D/utest] [ OK ] [ unit ] (test_assert_pass:26) is passed
+[D/utest] [ OK ] [ unit ] (test_assert_pass:28) is passed
+[D/utest] [ OK ] [ unit ] (test_assert_pass:29) is passed
+[I/utest] [ PASSED ] [ result ] testcase (testcases.utest.pass_tc)
+[I/utest] [----------] [ testcase ] (testcases.utest.pass_tc) finished
+[I/utest] [==========] [ utest ] finished
+```
+
+### 3. 提交
+
+1. 如果是对已有测试集合的完善,需要把添加的测试用例的配置项,以及对应的依赖项添加到对应测试集合的配置文件里,如:[examples\utest\configs\kernel\mem.conf](./configs/kernel/mem.conf)。
+
+```
+CONFIG_UTEST_MEMHEAP_TC=y
+
+# dependencies
+CONFIG_RT_USING_MEMHEAP=y
+```
+
+2. 如果要添加新的测试集合,需要参考已有的测试集合,在 [examples\utest\configs](./configs) 目录下添加新的测试集合配置项。并更新 [.github\workflows\action_utest.yml](../../.github/workflows/action_utest.yml) 内的测试集合。
+
+```
+- {UTEST: "kernel/mem", RTT_BSP: "bsp/qemu-vexpress-a9", QEMU_ARCH: "arm", QEMU_MACHINE: "vexpress-a9", CONFIG_FILE: "kernel/mem.conf", SD_FILE: "sd.bin"}
+- {UTEST: "components/utest", RTT_BSP: "bsp/qemu-vexpress-a9", QEMU_ARCH: "arm", QEMU_MACHINE: "vexpress-a9", CONFIG_FILE: "utest_self/self.conf", SD_FILE: "sd.bin"}
+```
+
+3. 向 RT-Thread 主仓库提交合并请求。 \ No newline at end of file
diff --git a/examples/utest/configs/kernel/mem.conf b/examples/utest/configs/kernel/mem.conf
new file mode 100644
index 0000000000..1a311ab9dd
--- /dev/null
+++ b/examples/utest/configs/kernel/mem.conf
@@ -0,0 +1,4 @@
+CONFIG_UTEST_MEMHEAP_TC=y
+
+# dependencies
+CONFIG_RT_USING_MEMHEAP=y
diff --git a/examples/utest/configs/utest_self/self.conf b/examples/utest/configs/utest_self/self.conf
new file mode 100644
index 0000000000..b155a551d2
--- /dev/null
+++ b/examples/utest/configs/utest_self/self.conf
@@ -0,0 +1 @@
+CONFIG_UTEST_SELF_PASS_TC=y
diff --git a/examples/utest/testcases/Kconfig b/examples/utest/testcases/Kconfig
new file mode 100644
index 0000000000..5dc1c6c420
--- /dev/null
+++ b/examples/utest/testcases/Kconfig
@@ -0,0 +1,16 @@
+menu "RT-Thread Utestcases"
+
+config RT_USING_UTESTCASES
+ bool "RT-Thread Utestcases"
+ default n
+ select RT_USING_UTEST
+
+if RT_USING_UTESTCASES
+
+source "$RTT_DIR/examples/utest/testcases/utest/Kconfig"
+source "$RTT_DIR/examples/utest/testcases/kernel/Kconfig"
+source "$RTT_DIR/examples/utest/testcases/drivers/serial_v2/Kconfig"
+
+endif
+
+endmenu
diff --git a/examples/utest/testcases/SConscript b/examples/utest/testcases/SConscript
new file mode 100644
index 0000000000..4c815c49b8
--- /dev/null
+++ b/examples/utest/testcases/SConscript
@@ -0,0 +1,15 @@
+# RT-Thread building script for bridge
+
+import os
+from building import *
+
+cwd = GetCurrentDir()
+objs = []
+list = os.listdir(cwd)
+
+for d in list:
+ path = os.path.join(cwd, d)
+ if os.path.isfile(os.path.join(path, 'SConscript')):
+ objs = objs + SConscript(os.path.join(d, 'SConscript'))
+
+Return('objs')
diff --git a/examples/utest/testcases/drivers/SConscript b/examples/utest/testcases/drivers/SConscript
new file mode 100644
index 0000000000..4c815c49b8
--- /dev/null
+++ b/examples/utest/testcases/drivers/SConscript
@@ -0,0 +1,15 @@
+# RT-Thread building script for bridge
+
+import os
+from building import *
+
+cwd = GetCurrentDir()
+objs = []
+list = os.listdir(cwd)
+
+for d in list:
+ path = os.path.join(cwd, d)
+ if os.path.isfile(os.path.join(path, 'SConscript')):
+ objs = objs + SConscript(os.path.join(d, 'SConscript'))
+
+Return('objs')
diff --git a/examples/utest/testcases/drivers/serial_v2/Kconfig b/examples/utest/testcases/drivers/serial_v2/Kconfig
new file mode 100644
index 0000000000..3c8d480b3a
--- /dev/null
+++ b/examples/utest/testcases/drivers/serial_v2/Kconfig
@@ -0,0 +1,7 @@
+menu "Utest Serial Testcase"
+
+config UTEST_SERIAL_TC
+ bool "Serial testcase"
+ default n
+
+endmenu
diff --git a/examples/utest/testcases/drivers/serial_v2/README.md b/examples/utest/testcases/drivers/serial_v2/README.md
new file mode 100644
index 0000000000..38d71ce8e8
--- /dev/null
+++ b/examples/utest/testcases/drivers/serial_v2/README.md
@@ -0,0 +1,120 @@
+## 1、介绍
+
+该目录下 c 文件是新版本串口的测试用例,在 `examples/utest/testcases/drivers/serial_v2` 目录结构里,该测试用例用来测试串口的各个操作模式是否正常工作。
+
+## 2、 文件说明
+
+| 文件 | 描述 |
+| ---------------- | ----------------------------------------- |
+| uart_rxb_txb.c | 串口接收阻塞和发送阻塞模式 的测试用例 |
+| uart_rxb_txnb.c | 串口接收阻塞和发送非阻塞模式 的测试用例 |
+| uart_rxnb_txb.c | 串口接收非阻塞和发送阻塞模式 的测试用例 |
+| uart_rxnb_txnb.c | 串口接收非阻塞和发送非阻塞模式 的测试用例 |
+
+## 3、软硬件环境
+
+硬件上需要支持 RT-Thread 的完整版操作系统,版本为4.0.4及以上,且硬件有串口硬件外设,软件上需要支持 内核接口、IPC 、Device 框架。
+
+## 4、测试项
+
+### 4.1 测试说明
+
+上文所提及的模式是指串口使用时的操作模式,不涉及硬件的工作模式的配置情况(硬件工作模式一般有轮询POLL、中断INT、DMA),因此使用时需要结合具体的硬件工作模式去配置使用。例如 发送阻塞和接收非阻塞模式 ,这个测试有很多种硬件配置,配置情况例如:DMA发送阻塞和DMA接收非阻塞,INT发送阻塞和DMA接收非阻塞,POLL发送阻塞和DMA接收非阻塞等等。因此通过排列组合后的测试场景有4*9=36种,有意义的组合方式为20种。如下表:
+
+
+| 接收非阻塞 | 发送阻塞 | 组合 | 有意义的组合方式 |
+| ---------- | -------- | ----------------- | ---------------- |
+| POLL | POLL | RX_POLL + TX_POLL | |
+| | INT | RX_POLL + TX_INT | |
+| | DMA | RX_POLL + TX_DMA | |
+| INT | POLL | RX_INT + TX_POLL | ✔ |
+| | INT | RX_INT + TX_INT | ✔ |
+| | DMA | RX_INT + TX_DMA | ✔ |
+| DMA | POLL | RX_DMA + TX_POLL | ✔ |
+| | INT | RX_DMA + TX_INT | ✔ |
+| | DMA | RX_DMA + TX_DMA | ✔ |
+
+| 接收非阻塞 | 发送非阻塞 | 组合 | 有意义的组合方式 |
+| ---------- | ---------- | ----------------- | ---------------- |
+| POLL | POLL | RX_POLL + TX_POLL | |
+| | INT | RX_POLL + TX_INT | |
+| | DMA | RX_POLL + TX_DMA | |
+| INT | POLL | RX_INT + TX_POLL | |
+| | INT | RX_INT + TX_INT | ✔ |
+| | DMA | RX_INT + TX_DMA | ✔ |
+| DMA | POLL | RX_DMA + TX_POLL | |
+| | INT | RX_DMA + TX_INT | ✔ |
+| | DMA | RX_DMA + TX_DMA | ✔ |
+
+| 接收阻塞 | 发送阻塞 | 组合 | 有意义的组合方式 |
+| -------- | -------- | ----------------- | ---------------- |
+| POLL | POLL | RX_POLL + TX_POLL | |
+| | INT | RX_POLL + TX_INT | |
+| | DMA | RX_POLL + TX_DMA | |
+| INT | POLL | RX_INT + TX_POLL | ✔ |
+| | INT | RX_INT + TX_INT | ✔ |
+| | DMA | RX_INT + TX_DMA | ✔ |
+| DMA | POLL | RX_DMA + TX_POLL | ✔ |
+| | INT | RX_DMA + TX_INT | ✔ |
+| | DMA | RX_DMA + TX_DMA | ✔ |
+
+| 接收阻塞 | 发送非阻塞 | 组合 | 有意义的组合方式 |
+| -------- | ---------- | ----------------- | ---------------- |
+| POLL | POLL | RX_POLL + TX_POLL | |
+| | INT | RX_POLL + TX_INT | |
+| | DMA | RX_POLL + TX_DMA | |
+| INT | POLL | RX_INT + TX_POLL | |
+| | INT | RX_INT + TX_INT | ✔ |
+| | DMA | RX_INT + TX_DMA | ✔ |
+| DMA | POLL | RX_DMA + TX_POLL | |
+| | INT | RX_DMA + TX_INT | ✔ |
+| | DMA | RX_DMA + TX_DMA | ✔ |
+
+需要解释的是,为什么会存在无意义的组合模式,举个例子,非阻塞模式下,肯定是不会出现POLL(轮询)方式的,因为POLL方式已经表明是阻塞方式了。
+该测试用例在测试多种组合时,需要通过更改`rtconfig.h`文件对硬件模式进行静态配置。
+
+### 4.2 测试思路
+
+这四个测试用例的测试思路基本一致。
+
+硬件上:**短接串口的发送TX引脚和接收RX引脚,完成自发自收的回路**。
+
+软件上:创建两个线程A和B,A为接收线程,B为发送线程,设置A线程优先级比B线程优先级高。发送线程发送随机长度(长度范围是 0 到 1000)的数据,接收线程接收到数据进行校验,数据正确则测试通过,默认测试100次。
+
+## 5、配置
+
+使用该测试用例需要在 `env` 工具的 `menuconfig` 中做相关配置,配置如下所示(使用 RT-Thread-Studio 的配置路径一致 ):
+
+```
+RT-Thread Utestcases --->
+ [*] RT-Thread Utestcases --->
+ Utest Serial Testcase --->
+ [*] Serial testcase
+```
+
+## 6、使用
+
+\- 编译下载。
+
+\- 在 MSH 中输入 `utest_run testcases.drivers.uart_rxb_txb` 运行串口接收阻塞和发送阻塞测试用例。
+
+\- 在 MSH 中输入 `utest_run testcases.drivers.uart_rxb_txb` 运行串口接收阻塞和发送阻塞测试用例。
+
+\- 在 MSH 中输入 `utest_run testcases.drivers.uart_rxb_txb` 运行串口接收阻塞和发送阻塞测试用例。
+
+\- 在 MSH 中输入 `utest_run testcases.drivers.uart_rxb_txb` 运行串口接收阻塞和发送阻塞测试用例。
+
+如果仅仅配置了 `Serial testcase` 相关的测试用例,则直接输入 `utest_run` 运行即可将上述测试用例按序测试。
+
+## 7、注意事项
+
+\- 需配置正确的测试用例。
+
+\- 如有需要,可开启 ULOG 查看测试用例日志信息。
+
+\- 需在 MSH 中输入正确的命令行。
+
+\- 测试用例默认的测试数据长度范围最大为1000字节,如果接收端的缓冲区大小配置为小于1000字节时,那么在测试接收阻塞模式时,将会由于获取不了1000字节长度导致线程持续阻塞(因为测试用例是按 `recv_len` 长度去接收的,而不是按照单字节去接收的),因此建议接收端的缓冲区大小 (对应宏例如为 `BSP_UART2_RX_BUFSIZE`)设置为1024即可;当然也可按需减小测试的最大数据长度。
+
+\- 该测试用例需要结合硬件具体的工作模式(POLL 、INT、DMA)进行测试,而硬件工作模式只能选择一种,因此需要在 `rtconfig.h` 中对串口相应的宏进行配置,来选择不同的工作模式去进行测试。
+
diff --git a/examples/utest/testcases/drivers/serial_v2/SConscript b/examples/utest/testcases/drivers/serial_v2/SConscript
new file mode 100644
index 0000000000..a7a46e656a
--- /dev/null
+++ b/examples/utest/testcases/drivers/serial_v2/SConscript
@@ -0,0 +1,16 @@
+Import('rtconfig')
+from building import *
+
+cwd = GetCurrentDir()
+src = Split('''
+uart_rxb_txnb.c
+uart_rxb_txb.c
+uart_rxnb_txb.c
+uart_rxnb_txnb.c
+''')
+
+CPPPATH = [cwd]
+
+group = DefineGroup('utestcases', src, depend = ['UTEST_SERIAL_TC'], CPPPATH = CPPPATH)
+
+Return('group')
diff --git a/examples/utest/testcases/drivers/serial_v2/uart_rxb_txb.c b/examples/utest/testcases/drivers/serial_v2/uart_rxb_txb.c
new file mode 100644
index 0000000000..8b2205ee1a
--- /dev/null
+++ b/examples/utest/testcases/drivers/serial_v2/uart_rxb_txb.c
@@ -0,0 +1,230 @@
+/*
+ * Copyright (c) 2006-2019, RT-Thread Development Team
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Change Logs:
+ * Date Author Notes
+ * 2021-06-16 KyleChan the first version
+ */
+
+#include <rtthread.h>
+#include "utest.h"
+#include <rtdevice.h>
+#include <stdlib.h>
+
+#define TC_UART_DEVICE_NAME "uart2"
+#define TC_UART_SEND_TIMES 100
+
+
+#ifdef UTEST_SERIAL_TC
+
+#define TEST_UART_NAME TC_UART_DEVICE_NAME
+
+static struct rt_serial_device *serial;
+static rt_uint8_t uart_over_flag;
+static rt_bool_t uart_result = RT_TRUE;
+
+static rt_err_t uart_find(void)
+{
+ serial = (struct rt_serial_device *)rt_device_find(TEST_UART_NAME);
+
+ if (serial == RT_NULL)
+ {
+ LOG_E("find %s device failed!\n", TEST_UART_NAME);
+ return -RT_ERROR;
+ }
+
+ return RT_EOK;
+}
+
+static void uart_send_entry(void *parameter)
+{
+ rt_uint8_t *uart_write_buffer;
+ rt_uint16_t send_len;
+
+ rt_uint32_t i = 0;
+ send_len = *(rt_uint16_t *)parameter;
+ /* assign send buffer */
+ uart_write_buffer = (rt_uint8_t *)rt_malloc(send_len);
+ if (uart_write_buffer == RT_NULL)
+ {
+ LOG_E("Without spare memory for uart dma!");
+ uart_result = RT_FALSE;
+ return;
+ }
+
+ rt_memset(uart_write_buffer, 0, send_len);
+
+ for (i = 0; i < send_len; i++)
+ {
+ uart_write_buffer[i] = (rt_uint8_t)i;
+ }
+ /* send buffer */
+ if (rt_device_write(&serial->parent, 0, uart_write_buffer, send_len) != send_len)
+ {
+ LOG_E("device write failed\r\n");
+ }
+ rt_free(uart_write_buffer);
+
+}
+
+static void uart_rec_entry(void *parameter)
+{
+ rt_uint16_t rev_len;
+
+ rev_len = *(rt_uint16_t *)parameter;
+ rt_uint8_t *ch;
+ ch = (rt_uint8_t *)rt_calloc(1, sizeof(rt_uint8_t) * (rev_len + 1));
+ rt_int32_t cnt, i;
+ rt_uint8_t last_old_data;
+ rt_bool_t fisrt_flag = RT_TRUE;
+ rt_uint32_t all_receive_length = 0;
+
+
+ while (1)
+ {
+ cnt = rt_device_read(&serial->parent, 0, (void *)ch, rev_len);
+ if (cnt == 0)
+ {
+ continue;
+ }
+
+ if (fisrt_flag != RT_TRUE)
+ {
+ if ((rt_uint8_t)(last_old_data + 1) != ch[0])
+ {
+ LOG_E("_Read Different data -> former data: %x, current data: %x.", last_old_data, ch[0]);
+ uart_result = RT_FALSE;
+ rt_free(ch);
+ return;
+ }
+ }
+ else
+ {
+ fisrt_flag = RT_FALSE;
+ }
+
+ for (i = 0; i < cnt - 1; i++)
+ {
+ if ((rt_uint8_t)(ch[i] + 1) != ch[i + 1])
+ {
+ LOG_E("Read Different data -> former data: %x, current data: %x.", ch[i], ch[i + 1]);
+
+ uart_result = RT_FALSE;
+ rt_free(ch);
+ return;
+ }
+ }
+ all_receive_length += cnt;
+ if (all_receive_length >= rev_len)
+ break;
+ else
+ last_old_data = ch[cnt - 1];
+ }
+ rt_free(ch);
+ uart_over_flag = RT_TRUE;
+}
+
+static rt_err_t uart_api(rt_uint16_t length)
+{
+ rt_thread_t thread_send = RT_NULL;
+ rt_thread_t thread_recv = RT_NULL;
+ rt_err_t result = RT_EOK;
+ uart_over_flag = RT_FALSE;
+
+ result = uart_find();
+ if (result != RT_EOK)
+ {
+ return -RT_ERROR;
+ }
+
+ /* Reinitialize */
+ struct serial_configure config = RT_SERIAL_CONFIG_DEFAULT;
+ config.baud_rate = BAUD_RATE_115200;
+ config.rx_bufsz = BSP_UART2_RX_BUFSIZE;
+ config.tx_bufsz = BSP_UART2_TX_BUFSIZE;
+ rt_device_control(&serial->parent, RT_DEVICE_CTRL_CONFIG, &config);
+
+ result = rt_device_open(&serial->parent, RT_DEVICE_FLAG_RX_BLOCKING | RT_DEVICE_FLAG_TX_BLOCKING);
+
+ if (result != RT_EOK)
+ {
+ LOG_E("Open uart device failed.");
+ uart_result = RT_FALSE;
+ return -RT_ERROR;
+ }
+
+ thread_send = rt_thread_create("uart_send", uart_send_entry, &length, 1024, RT_THREAD_PRIORITY_MAX - 4, 10);
+ thread_recv = rt_thread_create("uart_recv", uart_rec_entry, &length, 1024, RT_THREAD_PRIORITY_MAX - 5, 10);
+ if ((thread_send != RT_NULL) && (thread_recv != RT_NULL))
+ {
+ rt_thread_startup(thread_send);
+ rt_thread_startup(thread_recv);
+ }
+ else
+ {
+ result = -RT_ERROR;
+ goto __exit;
+ }
+
+ while (1)
+ {
+ if (uart_result != RT_TRUE)
+ {
+ LOG_E("The test for uart dma is failure.");
+ result = -RT_ERROR;
+ goto __exit;
+ }
+ if (uart_over_flag == RT_TRUE)
+ {
+ goto __exit;
+ }
+ /* waiting for test over */
+ rt_thread_mdelay(5);
+ }
+__exit:
+ rt_device_close(&serial->parent);
+ return result;
+}
+
+static void tc_uart_api(void)
+{
+ rt_uint32_t times = 0;
+ rt_uint16_t num = 0;
+ while (TC_UART_SEND_TIMES - times)
+ {
+ num = (rand() % 1000) + 1;
+ if(uart_api(num) == RT_EOK)
+ LOG_I("data_lens [%3d], it is correct to read and write data. [%d] times testing.", num, ++times);
+ else
+ {
+ LOG_E("uart test error");
+ break;
+ }
+ }
+ uassert_true(uart_over_flag == RT_TRUE);
+}
+
+static rt_err_t utest_tc_init(void)
+{
+ LOG_I("UART TEST: Please connect Tx and Rx directly for self testing.");
+ return RT_EOK;
+}
+
+static rt_err_t utest_tc_cleanup(void)
+{
+ uart_result = RT_TRUE;
+ uart_over_flag = RT_FALSE;
+
+ return RT_EOK;
+}
+
+static void testcase(void)
+{
+ UTEST_UNIT_RUN(tc_uart_api);
+}
+
+UTEST_TC_EXPORT(testcase, "testcases.drivers.uart_rxb_txb", utest_tc_init, utest_tc_cleanup, 30);
+
+#endif /* TC_UART_USING_TC */
diff --git a/examples/utest/testcases/drivers/serial_v2/uart_rxb_txnb.c b/examples/utest/testcases/drivers/serial_v2/uart_rxb_txnb.c
new file mode 100644
index 0000000000..f03a24fe13
--- /dev/null
+++ b/examples/utest/testcases/drivers/serial_v2/uart_rxb_txnb.c
@@ -0,0 +1,263 @@
+/*
+ * Copyright (c) 2006-2019, RT-Thread Development Team
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Change Logs:
+ * Date Author Notes
+ * 2021-06-16 KyleChan the first version
+ */
+
+#include <rtthread.h>
+#include "utest.h"
+#include <rtdevice.h>
+#include <stdlib.h>
+
+#define TC_UART_DEVICE_NAME "uart2"
+#define TC_UART_SEND_TIMES 100
+
+
+#ifdef UTEST_SERIAL_TC
+
+#define TEST_UART_NAME TC_UART_DEVICE_NAME
+
+static struct rt_serial_device *serial;
+static rt_sem_t tx_sem;
+static rt_uint8_t uart_over_flag;
+static rt_bool_t uart_result = RT_TRUE;
+
+static rt_err_t uart_find(void)
+{
+ serial = (struct rt_serial_device *)rt_device_find(TEST_UART_NAME);
+
+ if (serial == RT_NULL)
+ {
+ LOG_E("find %s device failed!\n", TEST_UART_NAME);
+ return -RT_ERROR;
+ }
+
+ return RT_EOK;
+}
+
+static rt_err_t uart_tx_completion(rt_device_t device, void *buffer)
+{
+ rt_sem_release(tx_sem);
+
+ return RT_EOK;
+}
+
+static void uart_send_entry(void *parameter)
+{
+ rt_uint8_t *uart_write_buffer;
+ rt_uint16_t send_len, len = 0;
+ rt_err_t result;
+
+ rt_uint32_t i = 0;
+ send_len = *(rt_uint16_t *)parameter;
+ /* assign send buffer */
+ uart_write_buffer = (rt_uint8_t *)rt_malloc(send_len);
+ if (uart_write_buffer == RT_NULL)
+ {
+ LOG_E("Without spare memory for uart dma!");
+ uart_result = RT_FALSE;
+ return;
+ }
+
+ rt_memset(uart_write_buffer, 0, send_len);
+
+ for (i = 0; i < send_len; i++)
+ {
+ uart_write_buffer[i] = (rt_uint8_t)i;
+ }
+ /* send buffer */
+ while (send_len - len)
+ {
+ len += rt_device_write(&serial->parent, 0, uart_write_buffer + len, send_len - len);
+ result = rt_sem_take(tx_sem, RT_WAITING_FOREVER);
+ if (result != RT_EOK)
+ {
+ LOG_E("take sem err in send.");
+ }
+ }
+ rt_free(uart_write_buffer);
+
+}
+
+static void uart_rec_entry(void *parameter)
+{
+ rt_uint16_t rev_len;
+
+ rev_len = *(rt_uint16_t *)parameter;
+ rt_uint8_t *ch;
+ ch = (rt_uint8_t *)rt_calloc(1, sizeof(rt_uint8_t) * (rev_len + 1));
+ rt_int32_t cnt, i;
+ rt_uint8_t last_old_data;
+ rt_bool_t fisrt_flag = RT_TRUE;
+ rt_uint32_t all_receive_length = 0;
+
+ while (1)
+ {
+ cnt = rt_device_read(&serial->parent, 0, (void *)ch, rev_len);
+ if (cnt != rev_len)
+ {
+ continue;
+ }
+
+ if (fisrt_flag != RT_TRUE)
+ {
+ if ((rt_uint8_t)(last_old_data + 1) != ch[0])
+ {
+ LOG_E("_Read Different data -> former data: %x, current data: %x.", last_old_data, ch[0]);
+ uart_result = RT_FALSE;
+ rt_free(ch);
+ return;
+ }
+ }
+ else
+ {
+ fisrt_flag = RT_FALSE;
+ }
+
+ for (i = 0; i < cnt - 1; i++)
+ {
+ if ((rt_uint8_t)(ch[i] + 1) != ch[i + 1])
+ {
+ LOG_E("Read Different data -> former data: %x, current data: %x.", ch[i], ch[i + 1]);
+
+ uart_result = RT_FALSE;
+ rt_free(ch);
+ return;
+ }
+ }
+ all_receive_length += cnt;
+ if (all_receive_length >= rev_len)
+ break;
+ else
+ last_old_data = ch[cnt - 1];
+ }
+ rt_free(ch);
+ uart_over_flag = RT_TRUE;
+}
+
+static rt_err_t uart_api(rt_uint16_t test_buf)
+{
+ rt_thread_t thread_send = RT_NULL;
+ rt_thread_t thread_recv = RT_NULL;
+ rt_err_t result = RT_EOK;
+ uart_over_flag = RT_FALSE;
+
+ result = uart_find();
+ if (result != RT_EOK)
+ {
+ return -RT_ERROR;
+ }
+
+ tx_sem = rt_sem_create("tx_sem", 0, RT_IPC_FLAG_PRIO);
+ if (tx_sem == RT_NULL)
+ {
+ LOG_E("Init sem failed.");
+ uart_result = RT_FALSE;
+ return -RT_ERROR;
+ }
+
+ /* Reinitialize */
+ struct serial_configure config = RT_SERIAL_CONFIG_DEFAULT;
+ config.baud_rate = BAUD_RATE_115200;
+ config.rx_bufsz = BSP_UART2_RX_BUFSIZE;
+ config.tx_bufsz = BSP_UART2_TX_BUFSIZE;
+ rt_device_control(&serial->parent, RT_DEVICE_CTRL_CONFIG, &config);
+
+ result = rt_device_open(&serial->parent, RT_DEVICE_FLAG_RX_BLOCKING | RT_DEVICE_FLAG_TX_NON_BLOCKING);
+
+ if (result != RT_EOK)
+ {
+ LOG_E("Open uart device failed.");
+ uart_result = RT_FALSE;
+ return -RT_ERROR;
+ }
+
+ /* set receive callback function */
+ result = rt_device_set_tx_complete(&serial->parent, uart_tx_completion);
+ if (result != RT_EOK)
+ {
+ goto __exit;
+ }
+
+ thread_recv = rt_thread_create("uart_recv", uart_rec_entry, &test_buf, 1024, RT_THREAD_PRIORITY_MAX - 5, 10);
+ thread_send = rt_thread_create("uart_send", uart_send_entry, &test_buf, 1024, RT_THREAD_PRIORITY_MAX - 4, 10);
+
+ if (thread_send != RT_NULL && thread_recv != RT_NULL)
+ {
+ rt_thread_startup(thread_recv);
+ rt_thread_startup(thread_send);
+ }
+ else
+ {
+ result = -RT_ERROR;
+ goto __exit;
+ }
+
+ while (1)
+ {
+ if (uart_result != RT_TRUE)
+ {
+ LOG_E("The test for uart dma is failure.");
+ result = -RT_ERROR;
+ goto __exit;
+ }
+ if (uart_over_flag == RT_TRUE)
+ {
+ goto __exit;
+ }
+ /* waiting for test over */
+ rt_thread_mdelay(5);
+ }
+__exit:
+ if (tx_sem)
+ rt_sem_delete(tx_sem);
+
+ rt_device_close(&serial->parent);
+ return result;
+}
+
+static void tc_uart_api(void)
+{
+ rt_uint32_t times = 0;
+ rt_uint16_t num = 0;
+ while (TC_UART_SEND_TIMES - times)
+ {
+ num = (rand() % 1000) + 1;
+ if(uart_api(num) == RT_EOK)
+ LOG_I("data_lens [%3d], it is correct to read and write data. [%d] times testing.", num, ++times);
+ else
+ {
+ LOG_E("uart test error");
+ break;
+ }
+ }
+ uassert_true(uart_over_flag == RT_TRUE);
+}
+
+static rt_err_t utest_tc_init(void)
+{
+ LOG_I("UART TEST: Please connect Tx and Rx directly for self testing.");
+ return RT_EOK;
+}
+
+static rt_err_t utest_tc_cleanup(void)
+{
+ tx_sem = RT_NULL;
+ uart_result = RT_TRUE;
+ uart_over_flag = RT_FALSE;
+
+ return RT_EOK;
+}
+
+static void testcase(void)
+{
+ UTEST_UNIT_RUN(tc_uart_api);
+}
+
+UTEST_TC_EXPORT(testcase, "testcases.drivers.uart_rxb_txnb", utest_tc_init, utest_tc_cleanup, 30);
+
+#endif
diff --git a/examples/utest/testcases/drivers/serial_v2/uart_rxnb_txb.c b/examples/utest/testcases/drivers/serial_v2/uart_rxnb_txb.c
new file mode 100644
index 0000000000..c1c88ddc9f
--- /dev/null
+++ b/examples/utest/testcases/drivers/serial_v2/uart_rxnb_txb.c
@@ -0,0 +1,266 @@
+/*
+ * Copyright (c) 2006-2019, RT-Thread Development Team
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Change Logs:
+ * Date Author Notes
+ * 2021-06-16 KyleChan the first version
+ */
+
+#include <rtthread.h>
+#include "utest.h"
+#include <rtdevice.h>
+#include <stdlib.h>
+
+#define TC_UART_DEVICE_NAME "uart2"
+#define TC_UART_SEND_TIMES 100
+
+
+#ifdef UTEST_SERIAL_TC
+
+#define TEST_UART_NAME TC_UART_DEVICE_NAME
+
+static struct rt_serial_device *serial;
+static rt_sem_t rx_sem;
+static rt_uint8_t uart_over_flag;
+static rt_bool_t uart_result = RT_TRUE;
+
+static rt_err_t uart_find(void)
+{
+ serial = (struct rt_serial_device *)rt_device_find(TEST_UART_NAME);
+
+ if (serial == RT_NULL)
+ {
+ LOG_E("find %s device failed!\n", TEST_UART_NAME);
+ return -RT_ERROR;
+ }
+
+ return RT_EOK;
+}
+
+static rt_err_t uart_rx_indicate(rt_device_t device, rt_size_t size)
+{
+ rt_sem_release(rx_sem);
+
+ return RT_EOK;
+}
+
+static void uart_send_entry(void *parameter)
+{
+ rt_uint8_t *uart_write_buffer;
+ rt_uint16_t send_len;
+
+ rt_uint32_t i = 0;
+ send_len = *(rt_uint16_t *)parameter;
+
+ /* assign send buffer */
+ uart_write_buffer = (rt_uint8_t *)rt_malloc(send_len);
+ if (uart_write_buffer == RT_NULL)
+ {
+ LOG_E("Without spare memory for uart dma!");
+ uart_result = RT_FALSE;
+ return;
+ }
+
+ rt_memset(uart_write_buffer, 0, send_len);
+
+ for (i = 0; i < send_len; i++)
+ {
+ uart_write_buffer[i] = (rt_uint8_t)i;
+ }
+
+ /* send buffer */
+ if (rt_device_write(&serial->parent, 0, uart_write_buffer, send_len) != send_len)
+ {
+ LOG_E("device write failed\r\n");
+ }
+ rt_free(uart_write_buffer);
+}
+
+static void uart_rec_entry(void *parameter)
+{
+ rt_uint16_t rev_len;
+
+ rev_len = *(rt_uint16_t *)parameter;
+ rt_uint8_t *ch;
+ ch = (rt_uint8_t *)rt_calloc(1, sizeof(rt_uint8_t) * (rev_len + 1));
+ rt_int32_t cnt, i;
+ rt_uint8_t last_old_data;
+ rt_bool_t fisrt_flag = RT_TRUE;
+ rt_uint32_t all_receive_length = 0;
+
+ while (1)
+ {
+ rt_err_t result;
+
+ result = rt_sem_take(rx_sem, RT_WAITING_FOREVER);
+ if (result != RT_EOK)
+ {
+ LOG_E("take sem err in recv.");
+ }
+
+ cnt = rt_device_read(&serial->parent, 0, (void *)ch, rev_len);
+ if (cnt == 0)
+ {
+ continue;
+ }
+
+ if (fisrt_flag != RT_TRUE)
+ {
+ if ((rt_uint8_t)(last_old_data + 1) != ch[0])
+ {
+ LOG_E("_Read Different data -> former data: %x, current data: %x.", last_old_data, ch[0]);
+ uart_result = RT_FALSE;
+ rt_free(ch);
+ return;
+ }
+ }
+ else
+ {
+ fisrt_flag = RT_FALSE;
+ }
+
+ for (i = 0; i < cnt - 1; i++)
+ {
+ if ((rt_uint8_t)(ch[i] + 1) != ch[i + 1])
+ {
+ LOG_E("Read Different data -> former data: %x, current data: %x.", ch[i], ch[i + 1]);
+
+ uart_result = RT_FALSE;
+ rt_free(ch);
+ return;
+ }
+ }
+ all_receive_length += cnt;
+ if (all_receive_length >= rev_len)
+ break;
+ else
+ last_old_data = ch[cnt - 1];
+ }
+ rt_free(ch);
+ uart_over_flag = RT_TRUE;
+}
+
+static rt_err_t uart_api(rt_uint16_t test_buf)
+{
+ rt_thread_t thread_send = RT_NULL;
+ rt_thread_t thread_recv = RT_NULL;
+ rt_err_t result = RT_EOK;
+
+ result = uart_find();
+ if (result != RT_EOK)
+ {
+ return -RT_ERROR;
+ }
+
+ rx_sem = rt_sem_create("rx_sem", 0, RT_IPC_FLAG_PRIO);
+ if (rx_sem == RT_NULL)
+ {
+ LOG_E("Init sem failed.");
+ uart_result = RT_FALSE;
+ return -RT_ERROR;
+ }
+
+ /* reinitialize */
+ struct serial_configure config = RT_SERIAL_CONFIG_DEFAULT;
+ config.baud_rate = BAUD_RATE_115200;
+ config.rx_bufsz = BSP_UART2_RX_BUFSIZE;
+ config.tx_bufsz = BSP_UART2_TX_BUFSIZE;
+ rt_device_control(&serial->parent, RT_DEVICE_CTRL_CONFIG, &config);
+
+ result = rt_device_open(&serial->parent, RT_DEVICE_FLAG_RX_NON_BLOCKING | RT_DEVICE_FLAG_TX_BLOCKING);
+
+ if (result != RT_EOK)
+ {
+ LOG_E("Open uart device failed.");
+ uart_result = RT_FALSE;
+ rt_sem_delete(rx_sem);
+ return -RT_ERROR;
+ }
+
+ /* set receive callback function */
+ result = rt_device_set_rx_indicate(&serial->parent, uart_rx_indicate);
+ if (result != RT_EOK)
+ {
+ goto __exit;
+ }
+
+ thread_recv = rt_thread_create("uart_recv", uart_rec_entry, &test_buf, 1024, RT_THREAD_PRIORITY_MAX - 5, 10);
+ thread_send = rt_thread_create("uart_send", uart_send_entry, &test_buf, 1024, RT_THREAD_PRIORITY_MAX - 4, 10);
+
+ if (thread_send != RT_NULL && thread_recv != RT_NULL)
+ {
+ rt_thread_startup(thread_recv);
+ rt_thread_startup(thread_send);
+ }
+ else
+ {
+ result = -RT_ERROR;
+ goto __exit;
+ }
+
+ while (1)
+ {
+ if (uart_result != RT_TRUE)
+ {
+ LOG_E("The test for uart dma is failure.");
+ result = -RT_ERROR;
+ goto __exit;
+ }
+ if (uart_over_flag == RT_TRUE)
+ {
+ goto __exit;
+ }
+ /* waiting for test over */
+ rt_thread_mdelay(5);
+ }
+__exit:
+ if (rx_sem)
+ rt_sem_delete(rx_sem);
+ rt_device_close(&serial->parent);
+ uart_over_flag = RT_FALSE;
+ return result;
+}
+
+static void tc_uart_api(void)
+{
+ rt_uint32_t times = 0;
+ rt_uint16_t num = 0;
+ while (TC_UART_SEND_TIMES - times)
+ {
+ num = (rand() % 1000) + 1;
+ if(uart_api(num) == RT_EOK)
+ LOG_I("data_lens [%3d], it is correct to read and write data. [%d] times testing.", num, ++times);
+ else
+ {
+ LOG_E("uart test error");
+ break;
+ }
+ }
+ uassert_true(uart_result == RT_TRUE);
+}
+
+static rt_err_t utest_tc_init(void)
+{
+ LOG_I("UART TEST: Please connect Tx and Rx directly for self testing.");
+ return RT_EOK;
+}
+
+static rt_err_t utest_tc_cleanup(void)
+{
+ rx_sem = RT_NULL;
+ uart_result = RT_TRUE;
+ uart_over_flag = RT_FALSE;
+
+ return RT_EOK;
+}
+
+static void testcase(void)
+{
+ UTEST_UNIT_RUN(tc_uart_api);
+}
+
+UTEST_TC_EXPORT(testcase, "testcases.drivers.uart_rxnb_txb", utest_tc_init, utest_tc_cleanup, 30);
+
+#endif /* TC_UART_USING_TC */
diff --git a/examples/utest/testcases/drivers/serial_v2/uart_rxnb_txnb.c b/examples/utest/testcases/drivers/serial_v2/uart_rxnb_txnb.c
new file mode 100644
index 0000000000..ad8d20b8cf
--- /dev/null
+++ b/examples/utest/testcases/drivers/serial_v2/uart_rxnb_txnb.c
@@ -0,0 +1,294 @@
+/*
+ * Copyright (c) 2006-2019, RT-Thread Development Team
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Change Logs:
+ * Date Author Notes
+ * 2021-06-16 KyleChan the first version
+ */
+
+#include <rtthread.h>
+#include "utest.h"
+#include <rtdevice.h>
+#include <stdlib.h>
+
+#define TC_UART_DEVICE_NAME "uart2"
+#define TC_UART_SEND_TIMES 100
+
+
+#ifdef UTEST_SERIAL_TC
+
+#define TEST_UART_NAME TC_UART_DEVICE_NAME
+
+static struct rt_serial_device *serial;
+static rt_sem_t tx_sem;
+static rt_sem_t rx_sem;
+static rt_uint8_t uart_over_flag;
+static rt_bool_t uart_result = RT_TRUE;
+
+static rt_err_t uart_find(void)
+{
+ serial = (struct rt_serial_device *)rt_device_find(TEST_UART_NAME);
+
+ if (serial == RT_NULL)
+ {
+ LOG_E("find %s device failed!\n", TEST_UART_NAME);
+ return -RT_ERROR;
+ }
+
+ return RT_EOK;
+}
+
+static rt_err_t uart_tx_completion(rt_device_t device, void *buffer)
+{
+ rt_sem_release(tx_sem);
+ return RT_EOK;
+}
+
+static rt_err_t uart_rx_indicate(rt_device_t device, rt_size_t size)
+{
+ rt_sem_release(rx_sem);
+ return RT_EOK;
+}
+
+static void uart_send_entry(void *parameter)
+{
+ rt_uint8_t *uart_write_buffer;
+ rt_uint16_t send_len, len = 0;
+ rt_err_t result;
+
+ rt_uint32_t i = 0;
+ send_len = *(rt_uint16_t *)parameter;
+ /* assign send buffer */
+ uart_write_buffer = (rt_uint8_t *)rt_malloc(send_len);
+ if (uart_write_buffer == RT_NULL)
+ {
+ LOG_E("Without spare memory for uart dma!");
+ uart_result = RT_FALSE;
+ return;
+ }
+
+ rt_memset(uart_write_buffer, 0, send_len);
+
+ for (i = 0; i < send_len; i++)
+ {
+ uart_write_buffer[i] = (rt_uint8_t)i;
+ }
+ /* send buffer */
+ while (send_len - len)
+ {
+ len += rt_device_write(&serial->parent, 0, uart_write_buffer + len, send_len - len);
+ result = rt_sem_take(tx_sem, RT_WAITING_FOREVER);
+ if (result != RT_EOK)
+ {
+ LOG_E("take sem err in send.");
+ }
+ }
+ rt_free(uart_write_buffer);
+
+}
+
+static void uart_rec_entry(void *parameter)
+{
+ rt_uint16_t rev_len;
+
+ rev_len = *(rt_uint16_t *)parameter;
+ rt_uint8_t *ch;
+ ch = (rt_uint8_t *)rt_calloc(1, sizeof(rt_uint8_t) * (rev_len + 1));
+ rt_int32_t cnt, i;
+ rt_uint8_t last_old_data;
+ rt_bool_t fisrt_flag = RT_TRUE;
+ rt_uint32_t all_receive_length = 0;
+
+ while (1)
+ {
+ rt_err_t result;
+
+ result = rt_sem_take(rx_sem, RT_WAITING_FOREVER);
+ if (result != RT_EOK)
+ {
+ LOG_E("take sem err in recv.");
+ }
+
+ cnt = rt_device_read(&serial->parent, 0, (void *)ch, rev_len);
+ if (cnt == 0)
+ {
+ continue;
+ }
+
+ if (fisrt_flag != RT_TRUE)
+ {
+ if ((rt_uint8_t)(last_old_data + 1) != ch[0])
+ {
+ LOG_E("_Read Different data -> former data: %x, current data: %x.", last_old_data, ch[0]);
+ uart_result = RT_FALSE;
+ rt_free(ch);
+ return;
+ }
+ }
+ else
+ {
+ fisrt_flag = RT_FALSE;
+ }
+
+ for (i = 0; i < cnt - 1; i++)
+ {
+ if ((rt_uint8_t)(ch[i] + 1) != ch[i + 1])
+ {
+ LOG_E("Read Different data -> former data: %x, current data: %x.", ch[i], ch[i + 1]);
+
+ uart_result = RT_FALSE;
+ rt_free(ch);
+ return;
+ }
+ }
+ all_receive_length += cnt;
+ if (all_receive_length >= rev_len)
+ break;
+ else
+ last_old_data = ch[cnt - 1];
+ }
+ rt_free(ch);
+ uart_over_flag = RT_TRUE;
+}
+
+static rt_err_t uart_api(rt_uint16_t test_buf)
+{
+ rt_thread_t thread_send = RT_NULL;
+ rt_thread_t thread_recv = RT_NULL;
+ rt_err_t result = RT_EOK;
+ uart_over_flag = RT_FALSE;
+
+ result = uart_find();
+ if (result != RT_EOK)
+ {
+ return -RT_ERROR;
+ }
+
+ rx_sem = rt_sem_create("rx_sem", 0, RT_IPC_FLAG_PRIO);
+ if (rx_sem == RT_NULL)
+ {
+ LOG_E("Init rx_sem failed.");
+ uart_result = RT_FALSE;
+ return -RT_ERROR;
+ }
+
+ tx_sem = rt_sem_create("tx_sem", 0, RT_IPC_FLAG_PRIO);
+ if (tx_sem == RT_NULL)
+ {
+ LOG_E("Init tx_sem failed.");
+ uart_result = RT_FALSE;
+ return -RT_ERROR;
+ }
+
+ /* reinitialize */
+ struct serial_configure config = RT_SERIAL_CONFIG_DEFAULT;
+ config.baud_rate = BAUD_RATE_115200;
+ config.rx_bufsz = BSP_UART2_RX_BUFSIZE;
+ config.tx_bufsz = BSP_UART2_TX_BUFSIZE;
+ rt_device_control(&serial->parent, RT_DEVICE_CTRL_CONFIG, &config);
+
+ result = rt_device_open(&serial->parent, RT_DEVICE_FLAG_RX_NON_BLOCKING | RT_DEVICE_FLAG_TX_NON_BLOCKING);
+
+ if (result != RT_EOK)
+ {
+ LOG_E("Open uart device failed.");
+ uart_result = RT_FALSE;
+ return -RT_ERROR;
+ }
+
+ /* set receive callback function */
+ result = rt_device_set_tx_complete(&serial->parent, uart_tx_completion);
+ if (result != RT_EOK)
+ {
+ goto __exit;
+ }
+
+ result = rt_device_set_rx_indicate(&serial->parent, uart_rx_indicate);
+ if (result != RT_EOK)
+ {
+ goto __exit;
+ }
+
+ thread_recv = rt_thread_create("uart_recv", uart_rec_entry, &test_buf, 1024, RT_THREAD_PRIORITY_MAX - 5, 10);
+ thread_send = rt_thread_create("uart_send", uart_send_entry, &test_buf, 1024, RT_THREAD_PRIORITY_MAX - 4, 10);
+
+ if (thread_send != RT_NULL && thread_recv != RT_NULL)
+ {
+ rt_thread_startup(thread_recv);
+ rt_thread_startup(thread_send);
+ }
+ else
+ {
+ result = -RT_ERROR;
+ goto __exit;
+ }
+
+ while (1)
+ {
+ if (uart_result != RT_TRUE)
+ {
+ LOG_E("The test for uart dma is failure.");
+ result = -RT_ERROR;
+ goto __exit;
+ }
+ if (uart_over_flag == RT_TRUE)
+ {
+ goto __exit;
+ }
+ /* waiting for test over */
+ rt_thread_mdelay(5);
+ }
+__exit:
+ if (tx_sem)
+ rt_sem_delete(tx_sem);
+
+ if (rx_sem)
+ rt_sem_delete(rx_sem);
+
+ rt_device_close(&serial->parent);
+ return result;
+}
+
+static void tc_uart_api(void)
+{
+ rt_uint32_t times = 0;
+ rt_uint16_t num = 0;
+ while (TC_UART_SEND_TIMES - times)
+ {
+ num = (rand() % 1000) + 1;
+ if(uart_api(num) == RT_EOK)
+ LOG_I("data_lens [%3d], it is correct to read and write data. [%d] times testing.", num, ++times);
+ else
+ {
+ LOG_E("uart test error");
+ break;
+ }
+ }
+ uassert_true(uart_over_flag == RT_TRUE);
+}
+
+static rt_err_t utest_tc_init(void)
+{
+ LOG_I("UART TEST: Please connect Tx and Rx directly for self testing.");
+ return RT_EOK;
+}
+
+static rt_err_t utest_tc_cleanup(void)
+{
+ tx_sem = RT_NULL;
+ uart_result = RT_TRUE;
+ uart_over_flag = RT_FALSE;
+
+ return RT_EOK;
+}
+
+static void testcase(void)
+{
+ UTEST_UNIT_RUN(tc_uart_api);
+}
+
+UTEST_TC_EXPORT(testcase, "testcases.drivers.uart_rxnb_txnb", utest_tc_init, utest_tc_cleanup, 30);
+
+#endif
diff --git a/examples/utest/testcases/kernel/Kconfig b/examples/utest/testcases/kernel/Kconfig
new file mode 100644
index 0000000000..14334af16f
--- /dev/null
+++ b/examples/utest/testcases/kernel/Kconfig
@@ -0,0 +1,8 @@
+menu "Kernel Testcase"
+
+config UTEST_MEMHEAP_TC
+ bool "memheap stability test"
+ default y
+ depends on RT_USING_MEMHEAP
+
+endmenu
diff --git a/examples/utest/testcases/kernel/SConscript b/examples/utest/testcases/kernel/SConscript
new file mode 100644
index 0000000000..9411cdd9a0
--- /dev/null
+++ b/examples/utest/testcases/kernel/SConscript
@@ -0,0 +1,15 @@
+Import('rtconfig')
+from building import *
+
+cwd = GetCurrentDir()
+src = Split('''
+''')
+
+if GetDepend(['UTEST_MEMHEAP_TC']):
+ src += ['memheap_tc.c']
+
+CPPPATH = [cwd]
+
+group = DefineGroup('utestcases', src, depend = [], CPPPATH = CPPPATH)
+
+Return('group')
diff --git a/examples/utest/testcases/kernel/memheap_tc.c b/examples/utest/testcases/kernel/memheap_tc.c
new file mode 100644
index 0000000000..ee52bdb185
--- /dev/null
+++ b/examples/utest/testcases/kernel/memheap_tc.c
@@ -0,0 +1,100 @@
+/*
+ * Copyright (c) 2006-2019, RT-Thread Development Team
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Change Logs:
+ * Date Author Notes
+ * 2019-01-16 flybreak the first version
+ */
+
+#include <rtthread.h>
+#include <stdlib.h>
+#include "utest.h"
+
+#define HEAP_SIZE (64 * 1024)
+#define HEAP_ALIGN (4)
+#define SLICE_NUM (40)
+#define TEST_TIMES (100000)
+#define HEAP_NAME "heap1"
+#define SLICE_SIZE_MAX (HEAP_SIZE/SLICE_NUM)
+
+static void memheap_test(void)
+{
+ struct rt_memheap heap1;
+ rt_uint32_t ptr_start;
+ void *ptr[SLICE_NUM];
+ int i, cnt = 0;
+
+ /* init heap */
+ ptr_start = (rt_uint32_t)rt_malloc_align(HEAP_SIZE, HEAP_ALIGN);
+ if (ptr_start == RT_NULL)
+ {
+ rt_kprintf("totle size too big,can not malloc memory!");
+ return;
+ }
+
+ rt_memheap_init(&heap1, HEAP_NAME, (void *)ptr_start, HEAP_SIZE);
+
+ /* test start */
+ for (i = 0; i < SLICE_NUM; i++)
+ {
+ ptr[i] = 0;
+ }
+ /* test alloc */
+ for (i = 0; i < SLICE_NUM; i++)
+ {
+ rt_uint32_t slice_size = rand() % SLICE_SIZE_MAX;
+ ptr[i] = rt_memheap_alloc(&heap1, slice_size);
+ }
+ /* test realloc */
+ while (cnt < TEST_TIMES)
+ {
+ rt_uint32_t slice_size = rand() % SLICE_SIZE_MAX;
+ rt_uint32_t ptr_index = rand() % SLICE_NUM;
+ rt_uint32_t operation = rand() % 2;
+
+ if (ptr[ptr_index])
+ {
+ if (operation == 0) /* free and malloc */
+ {
+ if (ptr[ptr_index])
+ {
+ rt_memheap_free(ptr[ptr_index]);
+ }
+ ptr[ptr_index] = rt_memheap_alloc(&heap1, slice_size);
+ }
+ else /* realloc */
+ {
+ ptr[ptr_index] = rt_memheap_realloc(&heap1, ptr[ptr_index], slice_size);
+ }
+ }
+ cnt ++;
+ if (cnt % (TEST_TIMES / 10) == 0)
+ {
+ rt_kprintf(">");
+ }
+ }
+
+ rt_kprintf("test OK!\n");
+
+ /* test end */
+ rt_memheap_detach(&heap1);
+ rt_free_align((void *)ptr_start);
+}
+
+static rt_err_t utest_tc_init(void)
+{
+ return RT_EOK;
+}
+
+static rt_err_t utest_tc_cleanup(void)
+{
+ return RT_EOK;
+}
+
+static void testcase(void)
+{
+ UTEST_UNIT_RUN(memheap_test);
+}
+UTEST_TC_EXPORT(testcase, "testcases.kernel.memheap_tc", utest_tc_init, utest_tc_cleanup, 10);
diff --git a/examples/utest/testcases/utest/Kconfig b/examples/utest/testcases/utest/Kconfig
new file mode 100644
index 0000000000..85b4d796bd
--- /dev/null
+++ b/examples/utest/testcases/utest/Kconfig
@@ -0,0 +1,7 @@
+menu "Utest Self Testcase"
+
+config UTEST_SELF_PASS_TC
+ bool "Pass test"
+ default y
+
+endmenu
diff --git a/examples/utest/testcases/utest/SConscript b/examples/utest/testcases/utest/SConscript
new file mode 100644
index 0000000000..1b35042e44
--- /dev/null
+++ b/examples/utest/testcases/utest/SConscript
@@ -0,0 +1,13 @@
+Import('rtconfig')
+from building import *
+
+cwd = GetCurrentDir()
+src = Split('''
+pass_tc.c
+''')
+
+CPPPATH = [cwd]
+
+group = DefineGroup('utestcases', src, depend = ['UTEST_SELF_PASS_TC'], CPPPATH = CPPPATH)
+
+Return('group')
diff --git a/examples/utest/testcases/utest/pass_tc.c b/examples/utest/testcases/utest/pass_tc.c
new file mode 100644
index 0000000000..c9ee912fbf
--- /dev/null
+++ b/examples/utest/testcases/utest/pass_tc.c
@@ -0,0 +1,46 @@
+/*
+ * Copyright (c) 2006-2019, RT-Thread Development Team
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Change Logs:
+ * Date Author Notes
+ * 2019-01-16 MurphyZhao the first version
+ */
+
+#include <rtthread.h>
+#include "utest.h"
+
+static void test_assert_pass(void)
+{
+ uassert_true(1);
+ uassert_false(0);
+
+ uassert_null(RT_NULL);
+ uassert_not_null(!RT_NULL);
+
+ uassert_int_equal(1, 1);
+ uassert_int_not_equal(1, 2);
+
+ uassert_str_equal("Hello RT-Thread!", "Hello RT-Thread!");
+ uassert_str_not_equal("Hello RT-Thread!", "Hello");
+
+ uassert_in_range(2048, 1024, 4096);
+ uassert_not_in_range(0, 1024, 4096);
+}
+
+static rt_err_t utest_tc_init(void)
+{
+ return RT_EOK;
+}
+
+static rt_err_t utest_tc_cleanup(void)
+{
+ return RT_EOK;
+}
+
+static void testcase(void)
+{
+ UTEST_UNIT_RUN(test_assert_pass);
+}
+UTEST_TC_EXPORT(testcase, "testcases.utest.pass_tc", utest_tc_init, utest_tc_cleanup, 10);